


United States Patent 19 [11] 4,449,182 
Rubinson et al. [45] May 15, 1984 
[54] INTERFACE BETWEEN A PAIR OF 4,318,174 3/1982 Suzukiet al. oo. 364/200 
PROCESSORS, SUCH AS HOST AND 4,334,305 6/1982 Girardi oo... eeeetseseeneees 364/200 
PERIPHERAL-CONTROLLING Primary Examiner—Joseph F. Ruggiero 
PROCESSORS IN DATA PROCESSING Assistant Examiner—Gary V. Harkcom 
SYSTEMS Attorney, Agent, or Firm—Cesari and McKenna 
[75] Inventors: Barry L. Rubinson; Edward A. [57] ABSTRACT 
Gardner; William A. Grace; Richard . . 
F. Lary; Dale R. Keck, all of An interface mechanism (10) between two processors, 
Colorado Springs, Colo. such as a host processor (70) and a processor (31) in an 
: ee : : intelligent controller (30) for mass storage devices (40), 
[73] Assignee: Digital Equipment Corporation, and utilizing a set of data structures employing a dedi- 
Maynard, Mass. cated communications region (80A) in host memory 
(21] Appl. No.: 308,826 (80). Interprocessor commands and responses are com- 
: municated as packets over an I/O bus (60) of the host 
[22] Filed: Oct. 5, 1981 (70), to and from the communication region (80A), 
(51) Int. C3 oe GO6F 9/46; GO6F 15/16 through a pair of ring-type queues (80D) and (80E). The 
(52) WSs Clee eves shecsecssvecasceteaeestcnehevecletadacdect 364/200 entry of each ring location (e.g., 132, 134, 136, 138) 
[58] Field of Search ... 364/200 MS File, 900 MS File; points to another location in the communications region 
371/21 where a command or response is placed. The filling and 
"i emptying of ring entries (132-138) is controlled through 
[56] Reterences Cited the use of an ‘ownership’ byte or bit (278) associated 
U.S. PATENT DOCUMENTS with each entry. The ownership bit (278) is placed in a 
3,940,601 2/1976 Henry et al. ................ 235/153 AC _ first state when the message source (70 or 31) has filled 
4,145,739 3/1979 Dunning et al 364/200 the entry and in a second state when the entry has been 
4,153,934 5/1979 Sato eee emptied. Each processor keeps track of the rings’ status, 
4,181,937 1/1980 Hattori et al. to prevent the sending of more messages than the rings 
4,195,351 3/1980 Barner et al. ..... can hold. These rings permit each processor to operate 
4,204,251 5/1980 Brudevold .... at its own speed, without creating race conditions and 
Wa laney a7 to Devnet at. bviate the need for hardware interlock capability on 
4,214,305 7/1980 Tokita et al. .. Spat Ane ne pabiity 
4,237,534 12/1980 Felix oes the 1/0 ‘bus (60). 
4,268,907 5/1981 Porter et al. .. ad 
4,282,572 8/1981 Mooreetal. oe 21 Claims, 19 Drawing Figures 










COMMAKD INTERRUPT 


BUS ADAPTER 








T/0 BUS 


HOST COMMAND RING PTR 
HOST RESPONSE RING PTR 


BUFFER 
6 
BUFFER 
M 















HOST CONTROLLER 
7 










| HIGH-LEVEL 
See 07 0 = 1/0 PROTOCOL 

] 

| 






SERVER 





| COMMUNICATIONS 1 PORT 
SERVER 









HOST | INTER- 
COMPUTER | FACE 






ps6l ‘st AEN «UdIeg ‘S'N 


PI JO [ 3904S 


781 6bb'P 


TRANSITION 
INDICATOR 





60 





rs6l ‘SI ARN = JUDIVg “SN 


¥I JO 7 J94§ 


781 ‘6rr'P 


130 
‘ 


133 





RP. 
144 
138 


132 






[RB+3] 
(EMPTY) 







139 
135 





[RB+4] 
(EMPTY) 





136 
134 


137 


Fig. 3B 





jusjed “SN 


#1 JO € 1204S PR6I ‘ST Ae 


781 6th 


U.S. Patent May 15, 1984 Sheet 4 of 14 4,449,182 


CONTROLLER 


ENTER 


PORT 









IS RESPONSE RING 
ENTRY AVAILABLE 
TO CONTROLLER? 





WRITE RESPONSE 
TO REST NSE RING: 
S n & a FC 

BITS 


206 


EMPTY = 


NOT EMPTY 






Fig. 44 


a ere ee ee cere et ms ane me are em cms ce ee ee 


TO FIG. 4B 


U.S. Patent 


May 15, 1984 Sheet 5 of 14 


HOST 






2l2 






ENTRY = HOSTS? 










SERVICE 
INTERRUPT & PROCESS 
RESPONS 


26 






UPDATE HOST*S 
RING POINTER 





TO FIG. 4C 


Fig. 48 


4,449,182 


U.S. Patent May 15, 1984 Sheet 6 of 14 4,449,182 


HOST 





TO FIG. 6 


U.S. Patent May 15, 1984 Sheet 7 of 14 4,449,182 


FROM FIG. 5 










ORME BY? 
C 


ONTROLLER 2 


240 YES 


READ INTO BUFFER 











NO COMMAND, RING 


| Se 


INTERRUPT 
INCREMENT 
POINTER 






Fig. 6 250 





U.S. Patent May 15, 1984 Sheet 8 of 14 4,449,182 


15 8 7 Q 






RESERVED 


ADP CH RSVD 
CMD INT 
RSP INT 


RSP DSC 0 
RSP DSC N 
CMD DSC 0 
CMD DSC 


Fig. 7 













252 
RINGBASE+0 


«1 


RINGBASE +2Nn-1 


RINGBASE*2N 


RINGBASE+2m+2Nn-2 


|= 


U.S. Patent May 15, 1984 Sheet 9 of 14 4,449,182 


15 0 
pe eae see aclale 
264 

he ene a eels 






15 87 4 3 Q 
MSG LENGTH 
CONNECTION ID MSGTYP CREDITS 







+1 





ADAPTER CHANNEL 





U.S. Patent May 15, 1984 Sheet 10 of 14 4,449,182 


11 10 


38~— EERE INTERRUPT VARIES 





318 / 314 
316 e 

Fig. 11 
34 0 






420 
ZEROES 


gpd012 (8) OPD400 (8) 


CONTROLLER IDENTIFIER 


ERROR CODE CHVRSN CSVRSN 


426A 426B 426C 





422A 






424 


426 





Fig. 13 


U.S. Patent May 15, 1984 Sheet 11 of 14 4,449,182 


HOST. RT/CONTROLLER 
HARD INIT. 





CONTROLLER 


324 












322 















SENSE INIT. RUN 
MINIMUM INTEGRITY 
DIAGNOSTICS 
INITIALIZATION 
STEP 4: 326 
WRITE SA REGISTER: 
19987 
N1Q]D 
RESERVED 
334 affairs 
SENSE Si 310 328 
SET; 332 330 
READ SA REGISTER 
336 
WRITE SA REGISTER 
151413 1110 876 6 
1|WIC RNG]R RNG|I 
hs pe tae INT VECTOR | 
350 
340 
338 344 «(346 «42348 
342 READ SA REGISTER: 
RUN INTEGRITY CHECK 
DIAGNOSTICS: 
CONDITIONALLY 
INTERRUPT HOST 
Fig. 12A 


TIME S 


U.S. Patent May 15, 1984 Sheet 12 of 14 4,449,182 


HOST CONTROLLER 


INITIALIZATION 352 
STEP 2: 


WRITE SA ross 
Wizlerig 37 s ; 


PORT a —- 
TYPE LNG {| LNG 












364 
READ SA REGISTER 356 354 
& VALIDATE ECHO * 360 358 
366 
WRITE SA 
15 REGISTER io 
RINGBASE 
LO ADDRESS am 
368 370 
READ SA 
REGISTER 
INITIALIZATION 
STEP 3: 374 
15, iG 3, ce SA REGISTER 
8 6 
INITIATE 
RSVD VECTOR 


378 
READ SA REGISTER 376 
& VALIDATE 
380 


WRITE SA 
1544 REGISTER: 


RINGBASE 
HI ADDRESS 


TIME 
Fig. 128 


U.S. Patent May 15, 1984 Sheet 13 of 14 4,449,182 
HOST CONTROLLER 
386 
READ SA 
368 REGISTER 
& WRITE ZEROES 


DETECT WRITING 
OF SA 


& WRITE TO SA 


VERIFY 
392 a HOST WROTE 
TO SA 





READ IP REGISTER 


& 
394 


DISREGARD 





VERIFY 
HOST 





READ IP 


396 






<100 Ms? 


INIT. STEP 4: oe 


WRITE SA REGISTER: 


A 1g 87 Q 
5] ooo RSVD |CTRLR pCODE VERS 
400 


TIME 


Fig. 120 


U.S. Patent May 15, 1984 Sheet 14 of 14 4,449,182 


HOST. NTROLLER 







402 
READ SA REGISTER 


VALIDATE MCODE 
VERSION 
404 
WRITE SA REGISTER 
15 87 219 
RESERVED Burst |£{6 









READ SA REGISTER: 
INIT. COMPLETE; 
START OPERATIONAL 
CODE 


TIME 


Fig. 120 


4,449,182 


1 


INTERFACE BETWEEN A PAIR OF PROCESSORS, 
SUCH AS HOST AND 
PERTIPHERAL-CONTROLLING PROCESSORS IN 
DATA PROCESSING SYSTEMS 


CROSS-REFERENCE TO RELATED 
APPLICATIONS 


This application relates to a data processing system, 
other aspects of which are described in the following 
commonly assigned applications filed on even date 
herewith, the disclosures of which are incorporated by 
reference herein to clarify the environment, intended 
use and explanation of the present invention: 

Ser. No. 308,771, titled Disk Format for Secondary 
Storage System and Ser. No. 308,593, titled Secondary 
Storage Facility Employing Serial Communication Be- 
tween Drive and Controller. 


FIELD OF THE INVENTION 


This invention relates to the field of data processing 
systems and, in particular to an interface between a host 
processor and a controlling processor for a storage 
facility or other peripheral device or subsystem in such 
systems. 


BACKGROUND OF THE INVENTION 


In data processing systems utilizing secondary stor- 
age facilities, communication between the host proces- 
sor, or main frame, and secondary storage facilities has 
a considerable impact on system performance. Second- 
ary storage facilities comprise elements which are not 
an integral part of a central processing unit and its ran- 
dom access memory element (i.e., together termed the 
host), but which are directly connected to and con- 
trolled by the central processing unit or other elements 
in the system. These facilities are also known as “mass 
storage” elements or subsystems and include, among 
other possibilities, disk-type or tape-type memory units 
(also called drives). 

In modern data processing systems, a secondary stor- 
age facility includes a controller and one or more drives 
connected thereto. The controller operates in response 
to signals from the host, usually on an input/output bus 
which connects together various elements in the system 
including the central processing unit. A drive contains 
the recording medium (e.g., a rotating magnetic disk), 
the mechanism for moving the medium, and electronic 
circuitry to read data from or store data on the medium 
and also to convert the data transferred between the 
medium and the controller to and from the proper for- 
mat. 

The controller appears to the rest of the system as 
simply an element on the input/output bus. It receives 
commands over the bus; these commands include infor- 
mation about the operation to be performed, the drive 
to be used, the size of the transfer and perhaps the start- 
ing address on the drive for the transfer and the starting 
address on some other system element, such as the ran- 
dom access memory unit of the host. The controller 
converts all this command information into the neces- 
sary signals to effect the transfer between the appropri- 
ate drive and other system elements. During the transfer 
itself, the controller routes the data to or from the ap- 
propriate drive and to or from the input/output bus or 
a memory bus. 

Controllers have been constructed with varying lev- 
els of intelligence. Basically, the more intelligent the 
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controller, the less detailed the commands which the 
central processing unit must issue to it and the less de- 
pendent the controller is on the host CPU for step-by- 
step instructions. Typically, controllers communicate 
with a host CPU at least partially by means of an inter- 
rupt mechanism. That is, when one of a predetermined 
number of significant events occurs, the controller gen- 
erates an interrupt request signal which the host sees a 
short time later; in response, the host stops what it is 
doing and conducts some dialogue with the controller 
to service the controller’s operation. Every interrupt 
request signal generated by the controller gives rise to a 
delay in the operation of the central processor. It is an 
object of the present invention to reduce that delay by 
reducing the frequency and number of interrupt re- 
quests. 

When an intelligent controller is employed, a further 
problem is to interlock or synchronize the operation of 
the processor in the controller with the operation of the 
processor in the host, so that in sending commands and 
responses back and forth, the proper sequence of opera- 
tion is maintained, race conditions are avoided, etc. 
Normally this is accomplished by using a communica- 
tions mechanism (i.e., bus) which is provided with a 
hardware interlock capability, so that each processor 
can prevent the other from transmitting out of turn or at 
the wrong time. 

Modern controllers for secondary storage facilities 
are usually so-called “intelligent” devices, containing 
one or more processors of their own, allowing them to 
perform sophisticated tasks with some degree of inde- 
pendence. Sometimes, a processor and a controller will 
share a resource with another processor, such as the 
host’s central processor unit. One resource which may 
be shared is a memory unit. 

It is well known that when two independent proces- 
sors share a common resource (such as a memory 
through which the processors and the processes they 
execute may communicate with each other), the opera- 
tion of the two processors (i.e., the execution of pro- 
cesses or tasks by them) must be “interlocked” or “syn- 
chronized,”’ so that in accessing the shared resource, a 
defined sequence of operations is maintained and so- 
called “race” conditions are avoided. That is, once a 
first processor starts using the shared resource, no other 
processor may be allowed to access that resource until 
the first processor has finished operating upon it. Opera- 
tions which otherwise might have occurred concur- 
rently must be constrained to take place seriatim, in 
sequence. Otherwise, information may be lost, a proces- 
sor may act upon erroneous information, and system 
operation will be unreliable. To prevent this from hap- 
pening, the communications mechanism (i.e., bus) 
which links together the processors and a shared re- 
source typically is provided with a hardware “‘inter- 
lock” or synchronization capability, by means of which 
each processor is prevented from operating on the 
shared resource in other than a predefined sequence. 

In the prior art, three interlock mechanisms are 
widely known for synchronizing processors within an 
operating system, to avoid race conditions. One author 
calls these mechanisms (1) the test-and-set instruction 
mechanism, (2) the wait and signal mechanism and (3) 
the P and V operations mechanism. S. Madnick and J. 
Donovan, Operating Systems, 4-$.2 at 251-55 
(McGraw Hill, Inc., 1974). That text is hereby incorpo- 
rated by reference for a description and discussion of 
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those mechanisms. Another author refers to three tech- 
niques for insuring correct synchronization when multi- 
ple processors communicate through a shared memory 
as (1) process synchronization by semaphores, (2) pro- 
cess synchronization by monitors and (3) process syn- 
chronization by monitors without mutual exclusion. C. 
Weitzman, Distributed Micro/Mini Computer Systems: 
Structure, Implementation and Application, 3.2 at 
103-14 (Prentice Hall, Inc., 1980). That text is hereby 
incorporated by reference for a description and discus- 
sion of those techniques. When applied to multiple pro- 
cessors which communicate with a shared resource by a 
bus, such mechanisms impose limitations on bus charac- 
teristics; they require, for example, that certain com- 
pound bus operations be indivisible, such as an opera- 
tion which can both test and set a so-called “sema- 
phore” or monitor without being interrupted while 
doing so. These become part of the bus description and 
specifications. 

If the testing of a semaphore were done during one 
bus cycle and the setting during a different bus cycle, 
two or more processors which want to use a shared 
resource might test its semaphore at nearly the same 
time. If the semaphore is not set, the processors all will 
see the shared resource as available. They will then try 
to access it; but only one can succeed in setting the 
semaphore and getting access; each of the other proces- 
sors, though, having already tested and found the re- 
source available, would go through the motions of set- 
ting the semaphore and reading or writing data without 
knowing it had not succeeded in setting the semaphore 
and accessing the resource. The data thus read will be 
erroneous and the data thus written could be lost. 

Not all buses, though, are designed to allow imple- 
mentation of such indivisible operations, since some 
buses were not designed with the idea of connecting 
multiple processors via shared resources. Consequently, 
such buses are not or have not been provided with 
hardware interlock mechanisms. 

When a bus does not have such a capability, resort 
frequently has been made to use of processor interrupts 
to control the secondary storage facility, or some com- 
bination of semaphores and interrupts (as in the Carne- 
gie-Mellon University C.mpp multi-minicomputer sys- 
tem described at pages 27-29 and 110-111 of the above- 
identified book by Weitzman), but those approaches 
have their drawbacks. If multiple processors on such a 
bus operate at different rates and have different opera- 
tions to perform, at least one processor frequently may 
have to wait for the other. This aggrevates the slow- 
down in processing already inherent in the use of inter- 
rupt contro] with a single processor. 

A further characteristic of prior secondary storage 
facilities is that when a host initially connects to a con- 
troller, it usually assumes, but cannot verify, that the 
controller is operating correctly. 

Therefore, it is an object of this invention to improve 
the operation of a secondary storage facility including a 
controller and a drive. 

A further object of this invention is to provide such a 
facility with an improved method for handling host- 
controller communications over a bus lacking a hard- 
ware interlock capability, whereby the processor in the 
host and controller can operate at different rates with 
minimal interrupts and avoidance of race conditions. 

Another object of this invention is to provide a com- 
munications mechanism for operation between control- 
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ler and host which permits the host to verify correct 
operation of the controller at the time of initialization. 

Still another object of the invention is to provide a 
communications mechanism which minimizes the gen- 
eration of host interrupts by the controller during peak 
input/output loads. 

Still another object of this invention is to provide an 
interface between host and controller which allows for 
parallel operation of multiple devices attached to an 
individual controller, with full duplexing of operation 
initiation and completion signals. 


SUMMARY OF THE INVENTION 


In accordance with this invention, the host-controller 
interconnection is accomplished through an interface 
which includes a set of data structures employing a 
dedicated communications region in host memory. This 
communications region is operated on by both the host 
and the peripheral controller in accordance with a set of 
rules discussed below. Basically, this interface has two 
layers: (1) a transport mechanism, which is the physical 
machinery for the bi-directional transmission of words 
and control signals between the host and the controller 
and (2) a port, which is both hardware for accomplish- 
ing exchanges via the transport mechanism and a pro- 
cess implementing a set of rules and procedures govern- 
ing those exchanges. This port “resides” partly in the 
host and partly in the controller and has the purposes of 
facilitating the exchange of control messages (i.e., com- 
mands and responses) and verifying the correct opera- 
tion of the transport mechanism. 

Commands and responses are transmitted between 
the host and a peripheral controller as packets, over an 
input/output bus of the host, via transfers which do not 
require processor interruption. These transfers occur to 
and from the dedicated communication region in the 
host memory. The port polls this region for commands 
and the host polls it for responses. A portion of this 
communication region comprises a command (i.e., 
transmission) list and another portion comprises a re- 
sponse (i.e., receiving) list. An input/output operation 
begins when the host deposits a command in the com- 
mand list. The operation is seen as complete when the 
corresponding response packet is removed by the host 
from the response list. 

More specifically, the communications region of host 
memory consists of two sections: (1) a header section 
and (2) a variable-length section. The header section 
contains interrupt identification words. The variable- 
length section contains the response and command lists, 
organized into “rings”. A “ring” is a group of memory 
locations which is addressable in rotational (i.e., mod- 
ulo) sequence, such that when an incrementing counter 
(modulo-buffer-size) is used for addressing the buffer, 
the address of the last location is the sequence is fol- 
lowed next by the address of the first location. Each 
buffer entry, termed a descriptor, includes (1) an ad- 
dress where a command may be found for transmission 
or where a response is written, as appropriate, and (2) a 
so-called “‘ownership” byte (which in its most elemen- 
tary form reduces to a sigle ownership bit) which is 
used by the processors to controll access to the entry. 

Because of properties which will be outlined below, 
the port may be considered to be effectively integral 
with the controller; all necessary connections between 
the host and peripheral can be established by the port- 
/controller when it is initialized. 
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The port can itself generate processor interrupts; this 
happens at the option of the host only when the com- 
mand ring makes a transition from a full to a not-full 
condition or when the response ring makes the converse 
transition from empty to non-empty. Thus, the rings 
buffer the asynchronous occurrence of command and 
response packets, so that under favorable conditions 
long strings of commands, responses and exchanges can 
be passed without having to interrupt the host proces- 
sor. 

An input/output operation begins when the host 
deposits a command into the command list. The opera- 
tion is seen as complete when the corresponding re- 
sponse is removed by the host from the response list. 
Only the host writes into the command ring (i.e., list) 
and only the controller writes into the response ring. 
The “ownership” bit for each ring entry is set to a first 
state by the processor which writes the ring entry and is 
cleared from that state by the other processor only after 
the command has been sent or the response read. In 
addition, after writing an entry, the same processor 
cannot alter it until the other processor has cleared that 
entry’s ownership bit. 

By organizing the command and response lists into 
rings and controlling their operation through a rigid 
sequential protocol which includes an ownership byte 
(or bit) for each ring entry and rules for setting and 
clearing the ownership byte, the host and controller 
processors are allowed to operate at their own rates and 
the need for a hardware bus interlock in avoided. This 
allows the system to utilize, for example, the UNIBUS 
communication interconnection of Digital Equipment 
Corp., Maynard, Mass., which is an exemplary bus 
lacking a hardware interlock feature. 

These and other features, advantages and objects of 
the present invention will become more readily appar- 
ent from the following detailed description, which 
should be read in conjunction with the accompanying 
drawings. 


BRIEF DESCRIPTION OF THE DRAWING 


FIG. 1 is a conceptual block diagram of a system 
employing an architecture in which the present inven- 
tion sees utility; 

FIG. 2 is a basic block diagram of a data processing 
system in which the present invention may be em- 
ployed; 

FIG. 3A is a system block diagram of an illustrative 
embodiment of a data processing system utilizing the 
interface of the present invention; 

FIGS. 3B and 3C are diagrammatic illustrations of a 
ring 80D or 80E of FIG. 3A. 

FIGS. 4A and 4B are elementary flow diagrams illus- 
trating the sequence of events when the controller 
wishes to send a response to the host; 

FIG. 5 is an elementary flow diagram showing the 
sequence of events when the host issues a command to 
the controller; 

FIG. 6 is a similar flow diagram showing the control- 
ler’s action in response to the host’s issuance of a com- 
mand; 

FIG. 7 is a diagrammatic illustration of the communi- 
cations area of host memory, including the command 
and response rings; 

FIG. 8 is a diagrammatic illustration of the formatted 
command and response descriptors which comprise the 
ring entries; 
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FIG. 9 is a diagrammatic illustration of the command 
and response message envelopes; 

FIG. 10 is a diagrammatic illustration of a buffer 
description according to the present invention; 

FIG. 11 is a diagrammatic illustration of the status 
and address (SA) register 38 of FIG. 3A; 

FIGS. 12A-12D are flow charts of the port/con- 
troller initialization sequence according to this inven- 
tion; and 

FIG. 13 is a diagrammatic illustration of the “‘last fail” 
response packet of this invention. 


DETAILED DESCRIPTION OF AN 
ILLUSTRATIVE EMBODIMENT 


The present invention sees particular utility in a data 
processing system having an architectural configuration 
designed to enhance development of future mass stor- 
age systems, at reduced cost. Such a system is shown in 
FIG. 1. In this system, a high level protocol (indicated 
at 1A) is employed for communications between a host 
computer 1 and intelligent mass storage controller to. 
Such a high level protocol is intended to free the host 
from having to deal with peripheral device-dependent 
requirements (such as disk geometry and error recovery 
strategies). This is accomplished in part through the use 
of a communications hierachy in which the host com- 
municates with only one or two peripheral device 
“class” drivers, such as a driver 4 instead of a different 
I/O driver for each model of peripheral device. For 
example, there may be one driver for all disk class de- 
vices and another for all tape class devices. 

Each class driver, in turn, communicates with a de- 
vice controller (e.g., 2) through an interface mechanism 
10. Much of the interface mechanism 10 is bus-specific. 
Therfore, when it is desired to connect a new mass 
storage device to the system, there is no need to change 
the host’s input/output processes or operating system, 
which are costly (in time, as well as money) to develop. 
Only the controller need be modified to any substantial 
degree, which is far less expensive. And much of that 
cost can be averted if the controller and host are made 
self-adaptive to certain of the storage device’s charac- 
teristics, as explained in the above-identified commonly 
assigned applications. 

Device classes are determined by their storage and 
transfer characteristics. For example a so-called “disk 
class” is characterized by a fixed block length, individ- 
ual block update capability, and random access. Simi- 
larly a so-called “tape class” is characterized by a vari- 
able block length, lack of block update capability, and 
sequential access. Thus, the terms “disk” and “tape”’ as 
used herein refer to devices with such characteristics, 
rather than to the physical form of the storage medium. 

Within the framework of this discussion, a system 
comprises a plurality of subsystems interconnected by a 
communications mechanism (i.e. a bus and associated 
hardware). Each subsystem contains a port driver, (4 or 
5) which interfaces the subsystem to the communica- 
tions mechanism. The communications mechanism con- 
tains a port (8 or 9) for each subsystem; the port is sim- 
ply that portion of the communications mechanism to 
which a port driver interfaces directly. 

FIG. 1 illustrates an exemplary system comprising a 
host 1 and an intelligent mass storage controller 2. Host 
1 includes a peripheral class driver 3 and a port driver 4. 
Controller 2, in turn, includes a counterpart port driver 
5 and an associated high-level protocol server 2. A 
communications mechanism 7 connects the host to the 
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controller, and vice-versa. The communications mecha- 
nism includes a port (i.e., interface mechanism) (8,9) for 
each port driver. 

The port drivers 4 and 5 provide a standard set of 
communications services to the processes within their 
subsystems; port drivers cooperate with each other and 
with the communications mechanism to provide these 
services. In addition, the port drivers shield the physical 
characteristics of the communications mechanism from 
processes that use the communications services. 

Class driver 3 is a process which executes within host 
1. Typically, a host class 1/O driver 3 communicates 
with a counterpart in the controller 2, called a high- 
level protocol server, 6. 

The high-level protocol server 6 processes host com- 
mands, passes commands to device-specific modules 
within the controller, and sends responses to host com- 
mands back to the issuing class driver. 

In actual implementation, it is also possible for the 
functions of the controller-side port driver 5 and port 9 
to be performed physically at the host side of the com- 
munications mechanism 7. This is shown in the example 
described below. Nevertheless, the diagram of FIG. 1 
still explains the architectural concepts involved. 

Note also that for purposes of the further explanation 
which follows, it is generally unnecessary to distinguish 
between the port and its port driver. Therefore, unless 
the context indicates otherwise, when the word “port” 
is used below, it presumes and refers to the inclusion of 
a port driver, also. 

Referring now to FIG. 2, there is shown a system 
level block diagram of a data processing system utiliz- 
ing the present invention. A host computer 1 (including 
an interface mechanism 10) employs a secondary stor- 
age subsystem 20 comprising a controller 30, a disk 
drive 40 and a controller-drive interconnection cable 
50. The host 1 communicates with the secondary stor- 
age subsystem 20 over an input/output bus 60. 

FIG. 3A expands the system definition to further 
explain the structure of the host 1, controller 30 and 
their interface. As illustrated there, the host 1 comprises 
four primary subunits: a central processor unit (CPU) 
70, a main memory 80, a system bus 90 and a bus adapter 
110. 

A portion 80A of memory 80 is dedicated to service 
as a communications region for accessing the remainder 
of memory 80. As shown in FIG. 3A, communications 
area 80A comprises four sub-regions, or areas. Areas 
80B and 80C together form the above-indicated header 
section of the communications area. Area 80B is used 
for implementing the bus adapter purge function and 
area 80C holds the ring transition interrupt indicators 
used by the port. The variable-length section of the 
communications region comprises the response list area 
80D and the command list area 80E. The lists in areas 
80D and 80E are organized into rings. Each entry, in 
each ring, in turn, contains a descriptor (see FIG. 10) 
pointing to a memory area of sufficient size to accom- 
modate a command or response message packet of pre- 
determined maximum length, in bytes. 

Host 1 may, for example, be a Model VAX-11/780 or 
PDP 11 computer system, marketed by Digital Equip- 
ment Corporation of Maynard, Mass. 

System bus 990 is a bi-directional information path and 
communications protocol for data exchange between 
the CPU 70, memory 80 and other host elements which 
are not shown (so as not to detract from the clarity of 
this explanation). The system bus provides checked 
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parallel information exchanges synchronous with a 
common system clock. A bus adapter 110 translates and 


‘ transfers signals between the system bus 90 and the 
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host’s input/output (1/O) bus 60. For example, the 1/O 
bus 60 may be the UNIBUS I/O connection, the system 
bus may be the syncronous backlane interconnection 
(SBI) of the VAX-11/780 computer, and the bus 
adapter 110 may be the Model DW780 UNIBUS 
Adapter, all Digital Equipment Corporation products. 

Controller 30 includes several elements which are 
used specifically for communicating with the host 1. 
There are pointers 32 and 34, a command buffer 36 and 
a pair of registers, 37 and 38. Pointers 32 and 34 keep 
track of the current host command ring entry and the 
host response ring entry, respectively. Command buff- 
ers 36 provide temporary storage for commands await- 
ing processing by the controller and a pair of registers 
37 and 38. Register 37, termed the “IP” register, is used 
for initialization and polling. Register 38, termed the 
“SA” register, is used for storing status and address 
information. 

A processor 31 is the “heart” of the controller 30; it 
executes commands from buffer 36 and does all the 
housekeeping to keep communications flowing between 
the host 1 and the drive 40. 

The physical realization of the transport mechanism 
includes the UNIBUS interconnection (or a suitable 
counterpart) 60, system bus 90 and any association host 
and/or controller-based logic for adapting to same, 
including memory-bus interface 82, bus adapter 110, 
and bus-controller interface 120. 

The operation of the rings may be better understood 
by referring to FIGS. 3B and 3C, where an exemplary 
four entry ring 130 is depicted. This ring may be either 
a command ring or a response ring, since only their 
application differs. Assume the ring 130 has been oper- 
ating for some time and we have started to observe it at 
an arbitrarily selected moment, indicated in FIG. 3B. 
There are four ring entry positions 132-138, with con- 
secutive addresses RB, RB+1, RB+4, respectively. 
Each ring entry has associated with it an ownership bit 
(133, 135, 137, 139) which is used to indicate its status. 
A write pointer (WP), 142, points to the most recent 
write entry; correspondingly, a read pointer (RP), 144, 
points to the most recent read entry. In, FIG. 3B, it will 
be seen that entry 138 has been read, as indicated by the 
position of RP 144 and the state of ownership bit 139. 
By convention, the ownership bit is set to 1 when a 
location has been filled (i.e., written) and to 0 when it 
has been emptied (i.e., read). The next entry to be read 
is 132. Its ownership bit 133 is set to 1, indicating that it 
already has been written. Once entry 132 is read, its 
ownership bit is cleared, to 0, as indicated in FIG. 3C. 
This completely empties the ring 130. The next entry 
134 cannot be read until it is written and the state of 
ownership bit 135 is changed. Nor can entry 132 be 
re-read accidentally, since its ownership bit has been 
cleared, indicating that it already has been read. 

Having thus provided a block diagram explanation of 
the invention, further understanding of this interface 
will require a brief digression to explain packet commu- 
nications over the system. 

The port is a communications mechanism in which 
communications take place between pairs of processes 
resident in separate subsystems. (As used herein, the 
term “subsystems” include the host computers and de- 
vice controllers; the corresponding processes are host- 
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resident class drivers and controller-resident protocol 
servers.) 

Communications between the pair of processes take 
place over a “connection” which is a soft communica- 
tions path through the port; a single port typically will 
implement several connections concurrently. Once a 
connection has been established, the following three 
services are available across that connection: (1) se- 
quential message; (2) datagram; and (3) block data trans- 
fer. 

When a connection is terminated, all outstanding 
communications on that connection are discarded; that 
is, the receiver “throws away” all unacknowledge mes- 
sages and the sender “forgets” that such messages have 
been sent. 

The implementation of this communications scheme 
on the UNIBUS interconnection 60 has the following 
characteristics: (1) communications are always point-to- 
point between exactly two subsystems, one of which is 
always the host; (2) the port need not be aware of map- 
ping or memory management, since buffers are identi- 
fied with a UNIBUS address and are contiguous within 
the virtual buss address space; and (3) the host need 
never directly initiate a block data transfer. 

The port effectively is integral with the controller, 
even though not full localized there. This result happens 
by virtue of the point-to-point property and the fact that 
the device controller knows the class of device (e.g., 
disk drive) which it controls; all necessary connections, 
therefore, can be established by the port/controller 
when it is initialized. 

The Sequential Message service guarantees that all 
messages sent over a given connection are transmitted 
sequentially in the order originated, duplicate-free, and 
that they are delivered. That is, messages are received 
by the receiving process in the exact order in which the 
sending process queued them for transmission. If these 
guarantees cease to be met, or if a message cannot be 
delivered for any reason, the port enters the so-called 
“fatal error” state (described below) and all port con- 
nections are terminated. 

The Datagram service does not quarantee reception, 
sequential reception of duplicate-free reception of data- 
grams, though the probability of failure may be required 
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such failures; thus, if the using processes do make such 
guarantees for datagrams, then the datagram service 
over the port becomes equivalent to the Sequential 
Message service. 

The Block Data Transfer service is used to move data 
between named buffers in host memory and a peripheral 
device controller. In order to allow the port to be un- 
aware of mapping or memory management, the 
“Name” of a buffer is merely the bus address of the first 
byte of the buffer. Since the host never directly initiates 
a block data transfer, there is no need for the host to be 
aware of controller buffering. 

Since the communicating processes are asynchro- 
nous, flow control is needed if a sending process is to be 
prevented from producing congestion or deadlock in a 
receiving process (i.e, by sending messages more 
quickly than the receiver can capture them). Flow con- 
trol simply guarantees that the receiving process has 
buffers in which to place incoming messages; if all such 
buffers are full, the sending process is forced to defer 
transmission until the condition changes. Datagram 
service does not use flow control. Consequently, if the 
receiving process does not have an available buffer, the 
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datagram is either processed immediately or discarded, 
which possibility explicitly is permitted by the rules of 
that service. By contrast, the Sequential Message ser- 
vice does use flow control. Each potential receiving 
process reserves, or pre-allocates, some number of buff- 
ers into which messages may be received over its con- 
nection. This number is therefore the maximum number 
of messages which the sender may have outstanding and 
unprocessed at the receiver, and it is communicated to 
the sender by the receiver in the form of a “credit” for 
the connection. When a sender has used up its available 
credit, it must wait for the receiver to empty and make 
available one of its buffers. The message credits machin- 
ery for the port of the present invention is described in 
detail below. 

The host-resident driver and the controller provides 
transport mechanism control facilities for dealing with: 
(1) transmission of commands and responses; (2) sequen- 
tial delivery of commands; (3) asynchronous commica- 
tion; (4) unsolicited responses; (5) full duplex communi- 
cation; and (6) port failure recovery. That is, com- 
mands, their responses and unsolicited “responses” (i.e., 
controller-to-host messages) which are not responsive 
to a command may occur at any time; full duplex com- 
munication is necessary to handle the bi-directional 
flow without introducing the delays and further buffer- 
ing needs which would be associated with simplex com- 
munications. It is axiomatic that the host issues com- 
mands in some sequence. They must be fetched by the 
controller in the order in which they were queued to 
the transport mechanism, even if not executed in that 
sequence. Responses, however, do not necessarily 
occur in the same order as the initiating commands; and 
unsolicited messages can occur at any time. Therefore, 
asynchronous communications are used in order to 
allow a response or controller-to-host message to be 
sent whenever it is ready. Finally, as to port failure 
recovery, the host’s port driver places a timer on the 
port, and reinitializes the port in the event the port times 
out. 

This machinery must allow repeated access to the 
same host memory location, whether for reads, writes, 
or any mixture of the two. 

The SA and IP registers (37 and 38) are in the 1/O 
page of the host address space, but in controller hard- 
ware. They are used for controlling a number of facets 
of port operation. These registers are always read as 
words. The register pair begins on a longword bound- 
ary. Both have predefined addresses. The IP register 
has two functions: first, when written with any value, it 
causes a “hard” initialization of the port and the device 
controller; second, when read while the port is operat- 
ing, it causes the controller to initiate polling of the 
command ring, as discussed below. The SA register 38 
has four functions: first, when read by the host during 
initialization, it communicates data and error informa- 
tion relating to the initialization process; second, when 
written by the host during initialization, it communi- 
cates certain host-specific parameters to the port; third, 
when read by the host during normal operation, it com- 
municates status information including port- and con- 
troller-detected fatal errors; and fourth, when zeroed by 
the host during initialization and normal operation, it 
signals the port that the host has successfully completed 
a bus adapter purge in response to a port-initiated purge 
request. 

The port driver in the host’s operating system exam- 
ines the SA register regularly to verify normal port- 
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‘controller operation. A self-detected port/controller 
fatal error is reported in the SA register as discussed 
below. 


Transmission of Commands and Responses-Overview 


When the controller desires to send a response to the 
host, a several step operational sequence takes place. 
This sequence is illustrated in FIGS. 4A and 4B. Ini- 
tially, the controller looks at the current entry in the 
response ring indicated by the response ring pointer 34 
and determines whether that entry is available to it (by 
using the “ownership” bit). (Step 202.) If not, the con- 
troller continues to monitor the status of the current 
entry until it becomes available. Once the controller has 
access to the current ring entry, it writes the response 
ito a response buffer in host memory, pointed to by 
that ring entry, and indicates that the host now “owns” 
that ring entry by clearing and “Ownership” bit; it also 
sets a “FLAG” bit, the function of which is discussed 
below. (Step 204.) 

Next, the port determines whether the ring has gone 
from an empty to a non-empty transition (step 206); if 
so, a potentially interruptable condition has occurred. 
Before an interrupt request is generated, however, the 
port checks to ensure that the “FLAG” bit is a 1 (step 
208); an interrupt request is signalled only on an affirma- 
tive indication (Step 210). 

Upon receipt of the interrupt request, the host, when 
it is able to service the interrupt, looks at the current 
entry in the response ring and determines whether it ts 
“owned” by the host or controller (i.e., whether it has 
yet been read by that host). (Step 212.) If it is owned by 
the controller, the interrupt request is dismissed as spu- 
rious. Otherwise, the interrupt request is treated as 
valid, so the host processes the response (Step 214) and 
then updates its ring pointer (Step 216). 

Similar actions take place when the host wants to 
send a command, as indicated in FIG. 5. To start the 
sequence, the host looks at the current command ring 
entry and determines whether that ring entry is owned 
by the host or controller. (Step 218.) If it is owned by 
the controller, the host starts a timer (Step 220.) (pro- 
vided that is the first time it is looking at that ring en- 
try), if the timer is not stopped (by the command ring 
entry becoming available to the host) and is allowed to 
time out, a failure is indicated; the port is the reinitial- 
ized. (Step 222.) If the host owns the ring entry, how- 
ever, it puts the packet address of the command in the 
current ring entry. (Step 224.) If a command ring trans- 
fer interrupt is desired (step 226), the FLAG bit is 
set=1 to so indicate (step 228). The host then sets the 
“ownership” bit =1 the ring entry to indicate that there 
is a command in that ring entry to be acted upon. (Step 
230.) The port is then told to “poll” the ring (i.e., the 
host reads the IP register, which action is interpreted by 
the port as a notification that the ring contains one or 
more commands awaiting transmission; in response, the 
port steps through the ring entries one by one until all 
entries awaiting transmission have been sent. (Step 232.) 

The host next determines whether it has additional 
commands to send. (Step 233.) If so, the process is re- 
peated; otherwise, it is terminated. 

In responding to the issuance of a command (see FIG. 
6), the port first detects the instruction to poll (i.e., the 
read operation to the IP register). (Step 234.) Upon 
detecting that signal, the port must determine whether 
there is a buffer available to receive a command. (Step 
236.) It waits until the buffer is available and then reads 
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the current ring entry to determine whether that ring 
entry is owned by the port or host. (Step 238.) If owned 


' by the port, the command packet is read into a buffer. 


(Step 240.) The FLAG bit is then set and the “owner- 
ship” bit in the ring entry is changed to indicate host 
ownership. (Step 242.) If not owned by the port, polling 
terminates. 

A test is then performed for interrupt generation. 
First the port determines whether the command ring 
has undergone a full to not-full transition. (Step 244.) If 
so, the port next determines whether the host had the 
FLAG bit set. (Step 246.) If the FLAG bit was set, an 
interrupt request is generated. (Step 248.) The ring 
pointer is then incremented. (Step 250.) 

Response packets continue to be removed after the 
one causing an interrupt and, likewise, command pack- 
ets continue to be removed by the port after a poll. 


The Communications Area 


The communications area is aligned on a 16-bit word 
boundary whose layout is shown in FIG. 7. Addresses 
for the words of the rings are identified relative to a 
“ringbase” address 252. The words in regions 80B, 80C 
whose addresses are ringbase-3, ringbase-2 and ring- 
base-1 (hereinafter designated by the shorthand [ring- 
base-3], etc., where the brackets should be read as the 
location ‘“‘whose address is”) are used as indicators 
which are set to zero by the host and which are set 
non-zero by the port when the port interrupts the host, 
to indicate the reason for the interrupt. Word [ringbase- 
3] indicates whether the port is requesting a bus adapter 
purge; the non-zero value is the adapter channel number 
contained in the high-order byte 254 and derived from 
the triggering command. (The host responds by per- 
forming the purge. Purge completion is signalled by 
writing zeros to the SA register). 

Word 256 [ringbase-2] signals that the command 
queue has transitioned from full to not-full. Its non-zero 
value is predetermined, such as one. Similarly, word 
258 [ringbase-19 indicates that the response queue has 
transitioned from empty to not-empty. Its non-zero 
value also is predetermined (e.g., one). 

Each of the command and response lists is organized 
into a ring whose entries are 32-bit descriptors. There- 
fore, for each list, after the last location in the list has 
been addressed, the next location in sequence to be 
addressed is the first location in the list. That is, each list 
may be addressed by a modulo-N counter, where N is 
the number of entries in the ring. The length of each 
ring is determined by the relative speeds with which the 
host and the port/controller generate and process mes- 
sages; it is unrelated to the controller command limit. 
At initialization time, the host sets the ring lenghts. 

Each ring entry, or formatted descriptor, has the 
layout indicated in FIG. 8. In the low-order 16-bit (260), 
the least significant bit, 262, is zero; that is, the envelope 
address [text+0] is word-aligned. The remaining low- 
order bits are unspecified and vary with the data. In the 
high-order portion 264 of the descriptor, the letter ‘““U” 
in bits 266 and 268 represent a bit in the high-order 
portion of an 18-bit UNIBUS (or other bus) address. 
Bits 270-276, labelled “‘Q”’, are available for extending 
the high-order bus address; they are zero for UNIBUS 
systems. The most significant bit, 278, contains the 
“ownership” bit (“0”) referred to above; it indicates 
whether the descriptor is owned by the host (O= 1), and 
acts as an interlock protecting the descriptor against 
premature access by either the host or the port. The 
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next lower bit, 280, is a “FLAG” bit (labelled “F’”) 
whose meaning varies depending on the state of the 
descriptor. When the port returns a descriptor to the 
host, it sets F=1, indicating that the descriptor is full 
and points to response. On the other hand, when the 
controller acquires a descriptor from the host, F=1 
indicates that the host wants a ring transition interrupt 
due to this slot. It assumes that transition interrupts 
were enabled during initialization and that this particu- 
lar slot triggers the ring transition. F=0 means that the 
host does not want a transition host interrupt, even if 
interrupts were enabled during initialization. The port 
always sets F=1 when returning a descriptor to the 
host; therefore, a host desiring to override ring transi- 
tion interrupts must always clear the FLAG bit when 
passing ownership of a descriptor to the port. 


Message Envelopes 


As stated above, messages are sent as packets, with an 
envelope address pointing to word [text+0] of a 16-bit, 
word-aligned message envelope formatted as shown in 
FIG. 9. 

The MSG LENGTH field 282 indicates the length of 
the message text, in bytes. For commands, the length 
equals the size of the command, starting with [text +0]. 
For responses, the host sets the length equal to the size 
of the response buffer, in bytes, starting with [text +O]. 
By design, the minimum acceptable size is 60 bytes of 
message text (i.e., 64 bytes overall). 

The message length field 282 is read by the port be- 
fore the actual transmission of a response. The port may 
wish to send a response longer than the host can accept, 
as indicated by the message length field. In that event, it 
will have to break up the message into a plurality of 
packets of acceptable size. Therefore, having read the 
message length field, the controller then sends a re- 
sponse whose length is either the host-specified message 
length or the length of the controller’s response, if 
smaller. The resulting value is set into the message 
length field and sent to the host with the message 
packet. Therefore, the host must re-initialize the value 
of that field for each proposed response. 

The message text is contained in bytes 284a-284m, 
labelled MBj. The “connection id” field 286 identifies 
the connection serving as source of, or destination for, 
the message in question. The “credits” field 288 gives 
the credit value associated with the message, which is 
discussed more fully below. The “msgtyp” field 290 
indicates the message type. For example, a zero may be 
used to indicate a sequential message, wherein the cred- 
its and message length fields are valid. A one may indi- 
cate a datagram, wherein the credits field must be zero, 
but message length is valid. Similarly, a two may indi- 
cate a credit notification, with the credits field valid and 
the message length field zero. 


Message Credits 


A credit-based message limit mechanism is employed 
for command and response flow control. The credits 
field 288 of the message envelope supports credit- 
accounting algorithm. The controller 30 has a buffer 36 
for holding up to M commands awaiting execution. In 
its first response, the controller will return in the credits 
field the number, M, of commands its buffer can hold. 
This number is one more than the controller’s accep- 
tance limit for non-immediate commands; the “extra” 
slot is provided to allow the host always to be able to 
issue an immediate-class command. If the credit account 
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has a value of one, then the class driver may issue only 
an immediate-type command. If the account balance is 
zero, the class driver may not issue any commands at 
all. 

The class driver remembers the number M in its 
“credit account”. Each time the class driver queues a 
command, it decrements the credit account balance by 
one. Conversely, each time the class driver receives a 
response, it increments the credit account balance by 
the value contained in the credits field of that response. 
For unsolicited responses, this value will be zero, since 
no command was executed to evoke the response; for 
solicited responses, it normally will be one, since one 
command generally gives one to one response. 

For a controller having M greater than 15, responses 
beyond the first will have credits greater than one, 
allowing the controller to “walk” the class driver’s 
credit balance up to the correct value. For a well- 
behaved class driver, enlarging the command ring be- 
yond the value M + 1 provides no performance benefits; 
in this situation command ring transition interrupts will 
not occur since the class driver will never fill the com- 
mand ring. 


The Ownership Bit 


The ownership bit 278 in each ring entry is like the 
flag on an old-fashioned mailbox. The postman raised 
the flag to indicate that a letter had been put in the box. 
When the box was emptied, the owner would lower the 
flag. Similarly, the ownership bit indicates that a mes- 
sage has been deposited in a ring entry, and whether or 
not the ring entry (i.e., mailbox) has been emptied. Once 
a message is written to a ring entry, that message must 
be emptied before a second message can be written over 
the first. 

For a command descriptor, the ownership bit “0” is 
changed from zero to one when the host has filled the 
descriptor and is releasing it to the port. Conversely, 
once the port has emptied the command descriptor and 
is returning the empty slot to the host, the ownership bit 
is changed from one to zero. That is, to send a command 
the host sets the ownership bit to one; the port clears it 
when the command has been received, and returns the 
empty slot to the host. 

To guarantee that the port/controller sees each com- 
mand in a timely fashion, whenever the host inserts a 
command in the command ring, it must read the IP 
register. This forces the port to poll if it was not already 
polling. 

For a response descriptor, when the ownership bit 0 
undergoes a transition from one to zero, that means that 
the port has filled the descriptor and is releasing it to the 
host. The reverse transition means that the host has 
emptied the response descriptor and is returning the 
empty slot to the port. Thus, to send a response the port 
clears the ownership bit, while and the host sets it when 
the response has been received, and returns the empty 
slot to the port. 

Just as the port must poll for commands, the host 
must poll for responses, particularly because of the 
possibility of unsolicited responses. 


Interrupts 


The transmission of a message will result in a host 
interrupt if and only if interrupts were armed (i.e., en- 
abled) suitably during initialization and one of the fol- 
lowing three conditions has been met: (1) the message 
was a command with flag 280 equal to one (i.e., F=1), 


4,449,182 


15 

and the fetching of the command by the port caused the 
command ring to undergo a transition from full to not- 
full; (2) if the message was a response with F= 1 and the 
depositing of the message by the port caused the re- 
sponse ring to make a transition from empty to not- 
empty; or (3) the port is interfaced to the host via a bus 
adapter and a command required the port/controller to 
re-access a given location during data transfer. (The 
latter interrupt means that the port/controller is re- 
questing the host to purge the indicated channel of the 
bus adapter.) 


Port Polling 


The reading of the IP register by the host causes the 
port/controller to poll for commands. The port/con- 
troller begins reading commands out of host memory; if 
the controller has an internal command buffering capa- 
bility, it will write commands into the buffer if they 
can’t be executed immediately. The port continues to 
poll for full command slots until the command ring is 
found to be empty, at which time it will cease polling. 
The port will resume polling either when the controller 
delivers a response to the host, or when the host reads 
the IP register. 

Correspondingly, response polling for empty slots 
continues until all commands buffered within the con- 
troller have been completed and the associated re- 
sponses have been sent to the host. 


Host Polling 


Since unsolicited responses are possible, the host 
cannot cease polling for responses when ali outstanding 
commands have been acknowledged, though. If it did, 
an accumulation of unsolicited messages would first 
saturate the response ring and then any controller inter- 
nal message buffers, blocking the controller and pre- 
venting it from processing additional commands. Thus, 
the host must at least occassionally scan the response 
ring, even when not expecting a response. One way to 
accomplish this is by using the ring transition interrupt 
facility described above; the host also should remove in 
sequence from the response ring as many responses as it 
finds there. 


Data Transmission 


Data transmission details are controller-dependent. 
There are certain generic characteristics, however. 

Data transfer commands are assumed to contain 
buffer descriptors and byte or word counts. The buffers 
serve as sources or sinks for the actual data transfers, 
which are effected by the port as non-processor (NPR 
or DMA) transfers under command-derived count con- 
trol to or from the specified buffers. A buffer descriptor 
begins at the first word allocated for this purpose in the 
formats of higher-level commands. When used with the 
UNIBUS interconnection, the port employs a two- 
word buffer descriptor format as illustrated in FIG. 10. 
As shown wherein, the bits in the low-order buffer 
address 292 are message-dependent. The bits labelled 
“U” (294, 296) in the high-order portion 298 of the 
buffer descriptor are the high-order bits of an 18-bit 
UNIBUS address. The bits 300-306, labelled “Q”, are 
usable as an extension to the high-order UNIBUS ad- 
dress, and are zero for UNIBUS systems. 

Repeated access to host memory locations must be 
allowed for both read and write operations, in random 
sequence, if the interfaces are to support higher-level 
protocol functions such as transfer restarts, compares, 
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from read to write, or vice versa, and prior to breaking 
an addressing sequence. Active cooperation of the host 
CPU is required for this action. The port signals its 
desire for an adapter channel purge, as indicated above 
under the heading ‘““The Communications Area”. The 
host performs the purge and writes zeroes to the SA 
register 38 to signal completion. 


Transmission Errors 


Four classes of transmission errors have been consid- 
ered in the design of this interface: (1) failure to become 
bus master; (2) failure to become interrupt master; (3) 
bus data timeout error; and (4) bus parity error. 

When the port (controller) attempts to access host 
memory, it must first become the ‘“‘master” of bus 60. To 
deal cleanly with the possibility of this exercise failing, 
the port sets up a corresponding “last fail” response 
packet (see below) before actually requesting bus ac- 
cess. Bus access is then requested and if the port timer 
expires, the host will reinitialize the port/controller. 
The port will then report the error via the “last fail” 
response packet (assuming such packets were eneable 
during the retnitialization). 

A failure to become interrupt master occurs when- 
ever the port attempts to interrupt the host and an ac- 
knowledgement is not forthcoming. It is treated and 
reported the same as a failure to become bus master, 
although the contents of its last fail response will, of 
course, be different. 

Bus data timeout errors involve failure to complete 
the transfer of control or data messages. If the control- 
ler retires a transfer after it has failed once, and a second 
try also fails, then action is taken responsive to the de- 
tection of a persistent error. If the unsuccessful opera- 
tion was a control transfer, the port writes a failure code 
into the SA register and then terminates the connection 
with the host. Naturally, the controller will have to be 
reinitialized. On the other hand, if the unsuccessful 
operation was a data transfer, the port/controller stays 
online to the host and the failure is reported to the host 
in the response packet for the involved operation. Bus 
parity errors are handled the same as bus data timeout 
errors. 


Fatal Errors 


Various fatal errors may be self-detected by the port 
or controller. Some of these may also arise while the 
controller is operating its attached peripheral device(s). 
In the event of a fatal error, the port sets in the SA 
register a one in its most significant bit, to indicate the 
existence of a fatal error, and a fatal error code in bits 
10-0. 


Interrupt Generation Rate 


Under steady state conditions, at most one ring inter- 
rupt will be generated for each operation (i.e., com- 
mand or response transmission). Under conditions of 
low I/O rate, this will be due to response ring transi- 
tions from empty to not-empty; with high I/O rate, it 
will be due to command ring transitions from full to 
not-full. If the operation rate fluctuates considerably, 
the ratio of interrupts to operations can be caused to 
decline from one-to-one. For example, an initially low 
but rising operation rate will eventually cause both the 
command and response rings to be partially occupied, at 
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which point interrupts will cease and will not resume 
until the command ring fills and begins to make full to 
not-full transitions. This point can be staved off by in- 
creasing the permissible depth of the command ring. 
Generally, the permissible depth of the response ring 
will have to be increased also, since saturation of the 
response ring will eventually cause the controller to be 
unwilling to fetch additional commands. At that point, 
the command queue will saturate and each fetch will 
generate an interrupt. 

Moreover, a full condition in either ring implies that 
the source of that ring’s entries is temporarily choked 
off. Consequently, ring sizes should be large enough to 
keep the incidence of full rings small. For the command 
ring, the optimal size depends on the latency in the 
polling of the ring by the controller. For the response 
ring, the optimal size is a function of the latency in the 
ring-emptying software. 


Initialization 


A special initialization procedure serves to (1) iden- 
tify the parameters of the host-resident communications 
region to the port; (2) provide a confidence check on 
port/controller integrity; and (3) bring the port/con- 
troller online to the host. 

The initialization process starts with a ‘thard”’ initial- 
ization during which the port/controller runs some 
preliminary diagnostics. Upon successful completion of 
those diagnostics, there is a four step procedure which 
takes place. First, the host tells the controller the 
lengths of the rings, whether initialization interrupts are 
to be armed (i.e., enabled) and the address(es) of the 
interrupt vector(s). The port/controller then runs a 
complete internal integrity check and signals either 
success or failure. Second, the controller echos the ring 
lengths, and the host sends the low-order portion of the 
ringbase address and indicates whether the host is one 
which requires purge interrupts. Third, the controller 
sends an echo of the interrupt vector address(es) and the 
initialization interrupt arming signal. The host then 
replies with the high-order portion of the ringbase ad- 
dress, along with a signal which conditionally triggers 
an immediate test of the polling and adapter purge func- 
tions of the port. Fourth, the port tests the ability of the 
input/output bus to perform nonprocessor (NPR) trans- 
fers. If successful, the port zeroes the entire communica- 
tions area and signals the host that initialization is com- 
plete. The port then awaits a signal from the host that 
the controller should begin normal operation. 

At each step, the port informs the host of either suc- 
cess or failure. Success leads to the next initialization 
step and failure causes a restart of the initialization se- 
quence. The echoing of information to the host is used 
to check all bit positions in the transport mechanism and 
the IP and SA registers. 

The SA register is heavily used during initialization. 
The detailed format and meaning of its contents depend 
on the initialization step involved and whether informa- 
tion is being read from or written into the register. 
When being read, certain aspects of the SA format are 
constant and apply to all steps. This constant SA read 
format is indicated in FIG. 11. As seen there, the mean- 
ing of bits 15-11 of SA register 38 is constant but the 
interpretation of bits 10-0 varies. The S4-S1 bits, 
316-310, are set separately by the port to indicate the 
initialization step number which the port is ready to 
perform or is performing. The S1 bit 310 is set for ini- 
tialization step 1; the S2 bit 312, for initialization step 2, 
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etc. If the host detects more than one of the S1-S4 bits 
316-310 set at any time, it restarts the initialization of the 
port/controller; the second time this happens, the port- 
/controller is presumed to be malfunctioning. The SA 
register’s most significant bit 318, labelled ER, normally 
is zero; if it takes on the value of 1, then either a port- 
/controllerbased diagnostic test has failed, or there has 
been a fatal error. In the event of such a failure or error, 
bits 10-0 comprise a field 320 into which an error code 
is written; the error code may be either port-generic or 
controller-dependent. Consequently, the host can deter- 
mine not only the nature of an error but also the step of 
the initialization during which it occurred. If no step bit 
is set but ER =], a fatal error was detected during hard 
initialization, prior to the start of initialization step 1. 

The occurrence of an initialization error causes the 
port driver to retry the initialization sequence at least 
once. 

Reference will now be made to FIGS. 12A-12D, 
wherein the details of the initialization process are illus- 
trated. 

The host begins the initialization sequence either by 
performing a hard initialization of the controller (this is 
done either by issuing a bus initialization (INIT) com- 
mand (Step 322) or by writing zeroes to the IP register. 
The port guarantees that the host reads zeroes in the SA 
register on the next bus cycle. The controller, upon 
sensing the initialization order, runs a predetermined set 
of diagnostic routines intended to ensure the minimum 
integrity necessary to rely on the rest of the sequence. 
(Step 324.) Initialization then sequences through the 
four above-listed steps. 

At the beginning of each initialization step n, the port 
clears bit S,., before setting bit S,; thus, the host will 
never see bits S,.; and S, set simultaneously. From the 
viewpoint of the host, step n begins when reading the 
SA register results in the transition of bit S, from 0 to 1. 
Each step ends when the next step begins, and an inter- 
rupt may accompany the step change if interrupts are 
enabled. 

Each of initialization steps 1-3 is timed and if any of 
those steps fails to complete within the alloted time, that 
situation is treated as a host-detected fatal error. By 
contrast, there is no explicit signal for the completion of 
initialization step 4; rather, the host observes either that 
controller operation has begun or that a higher-level 
protocol-dependent timer has expired. 

The controller starts initialization step 1 by writing to 
the SA register 38 the pattern indicated in FIG. 12A. 
(Step 326.) Bits 338-332 are controller-dependent. The 
“NV” bit, 332, indicates whether the port supports a 
host-settable interrupt vector address; a bit value of | 
provides a negative answer. The “QB” bit, 330, indi- 
cates whether the port supports a 22-bit host bus ad- 
dress; a I indicates an affirmative answer. The “DI”, bit 
328, indicates whether the port implements enhanced 
diagnostics, such as wrap-around, purge and poll test; 
an affirmative answer is indicated by a bit value of 1. 

The host senses the setting of bit 310, the S1 bit, and 
reads the SA register. (Step 334.) It then responds by 
writing into the SA register the pattern shown in step 
336. The most significant bit 338 in the SA register 38 is 
set to a I, to guarantee that the port does not interpret 
the pattern as a host ‘adapter purge ccomplete’’ re- 
sponse (after a spontaneous reinitialization). The WR 
bit, 340, indicates whether the port should enter a diag- 
nostic wrap mode wherein it will echo messages sent to 
it; a bit value of 1 will cause the port to enter that mode. 
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The port will ignore the WR bit if DI=0 at the begin- 
ning of initialization step 1. Field 342, commprising bits 
13-11 and labelled “C RNG LNG,” indicates the num- 
ber of entries or slots in the command ring, expressed as 
a power of 2. Similarily, field 344, comprising bits 10-8 
and labelled “R RNG LNG”, represents the number of 
response ring slots, also expressed as a power of 2. Bit 
346, the number 7 bit in the register, labelled “IE”, 
indicates whether the host is arming interrupts at the 
completion of each of steps 1-3. An affirmative answer 
is indicated by a 1. Finally, field 348, comprising regis- 
ter bits 6-0, labelled “INT Vector”, contains the address 
of the vector to which all interrupts will be directed, 
divided by 4. If this address is 0, then port interrupts 
will not be generated under any circumstances. If this 
field is non-zero the controller will generate initializa- 
tion interrupts (if IE is set) and purge interrupts (if PI is 
set), and ring transition interrupts depending on the 
FLAG bit setting of the ring entry causing the transi- 
tion. 

The port/controller reads the SA register after it has 
been written by the host and then begins to run its full 
integrity check diagnostics; when finished, it condition- 
ally interrupts the host as described above. (Step 350.) 

This completes step 1 of the initalization process. 
Next, the controller writes a pattern to the SA register 
as indicated in FIG. 12B. (Step 352.) As shown there, 
bits 7-0 of the SA register echo bits 15-8 in step 336. The 
response and command ring lengths are echoed in fields 
354 and 356, respectively; bit 358 echoes the host’s WR 
bit and bit 360 echoes the host's bit 15. The port type is 
indicated in field 362, register bits 10-8, and bit 12 is set 
to a 1 to indicate the beginning of step 2. 

The host reads the SA register and validates the echo 
when it sees bit S2 change state. (Step 364.) If every- 
thing matches up, the host then responds by writing into 
the SA register the pattern indicated in step 366. Field 
368, comprising SA register bits 15-1, labelled “ringbase 
lo addres”, represents the low-order portion of the ad- 
dress of the word [ringbase +0] in the communications 
area. While this is a 16-bit byte address, its lowest order 
bit is 0, implicitly. The lowest order bit of the SA regis- 
ter, 370, indicated as “PI”, when set equal to 1, means 
that the host is requesting adapter purge interrupts. 

The controller reads the low ringbase address (Step 
372) and then writes into the SA register the pattern 
indicated in step 374, which starts initialization step 3 by 
causing bit 376, the S3 bit, to undergo a transition from 
0 to 1. The interrupt vector field 348 and interrupt en- 
abling bit 346 from step 336 are echoed in SA register 
bits 7-0. 

Next, the host reads the SA register and validates the 
echo; if the echo did not operate properly, an error is 
signalled. (Step 378). Assuming the echo was valid, the 
host then writes to the SA register the pattern indicated 
in step 380. Bit 382, the most significant bit, labelled 
“PP”, is written with an indication of whether the host 
is requesting execution of “purge”’ and ‘‘poll” tests (de- 
scribed elsewhere); an affirmative answer is signaled by 
a lL. The port will ignore the PP bit if the DI bit 328 was 
zero at the beginning of step 1. The “ringbase hi ad- 
dress” field 384, comprising SA register bits 14-0, is the 
high-order portion of the address {ringbase + 0]. 

The port then reads the SA register; if the PP bit has 
been set, the port writes zeroes into the SA register, to 
signal its readiness for the test. (Step 386.) The host 
detects that action and itself writes zeroes (or anything 
else) to the SA register, to simulate a “purge com- 
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(Step 392.) This simulates a “start polling’ command 
from the host to the port. The port verifies that the IP 
register was read, step 394, before the sequence contin- 
ues. The host is given a predetermined time from the 
time the SA register was first written during initializa- 
tion step 3 within which to complete these actions. 
(Step 396) If it fails to do so, initialization stops. The 
host may then restart the initialization sequence from 
the beginning. 

Upon successful completion of intialization step 3, the 
transition to intialization step 4 is effectuated when the 
controller writes to the SA register the pattern indi- 
cated in step 398. Field 400, comprising bits 7-0 of the 
SA register, contains the version number of the port- 
/controller microcode. In a microprogrammed control- 
ler, the functionality of the controller can be altered by 
changing the programming. It is therefore important 
that the functionality of the host and controiler be com- 
patible. The system designer can equip the host with the 
ability to recognize which versions of the controller 
microcode are compatible with the host and which are 
not. Therefore, the host checks the controller micro- 
code version in field 400 and confirms that the level of 
functionality is appropriate to that particular host. (Step 
402.) The host responds by writing into the SA register 
the pattern indicated in step 404. It is read by the con- 
troller in step 405 and 406 and the operational micro- 
code is then started. 

The “burst” field in bits 7-2 of the SA register is one 
less than the maximum number of longwords the host is 
willing to allow per NPR (nonprocessor involved) 
transfer. The port uses a default burst count if this field 
is zero. The values of both the default and the maximum 
the port will accept are controller-dependent. If the 
“LF” bit 408 is set equal to 1, that indicates that the host 
wants a “‘last fail” response packet when initialization is 
completed. The state of the LF bit 408 does not have 
any effect on the enabling/disabling of unsolicited re- 
sponses. The meaning of ‘“‘last fail” is explained below. 
The “GO” bit 410 indicates whether the controller 
should enter its functional microcode as soon as initial- 
ization completes. If GO=0, when initialization com- 
pletes, the port will continue to read the SA register 
until the host forces bit 0 of that register to make the 
transition from Q to I. 

At the end of initialization step 4, there is no explicit 
interrupt request. Instead, if interrupts were enabled, 
the next interrupt will be due to a ring transition or to an 
adapter purge request. 


Diagnostic Wrap Mode 


Diagnostic Wrap Mode (DWM) provides host-based 
diagnostics with the means for the lowest levels of host- 
controller communication via the port. In DWM, the 
port attempts to echo in the SA register 38 any data 
written to that register by the host. DWM is a special 
path through initialization step 1; initialization steps 2-4 
are suppressed and the port/controller is left discon- 
nected from the host. A hard initialization terminates 
DWM and, if the results of DWM are satisfactory, it is 
then bypassed on the next initialization sequence. 


Last Fail 


“Last fail” is the name given to a unique response 
packet which is sent if the port/controller detected an 
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error during a previous “run” and the LF bit 405 was 
set in step 404 of the current initialization sequence. It is 
sent when initialization completes. The format of this 
packet is indicated in FIG. 3. The packet starts with 64 
bits of zeros in a pair of 32 bit words 420. Next there is 
a 32 bit word 422 consisting of a lower-order byte 422A 
and a higher-order byte 422B, each of which has a 
unique numerical contents. Word 422 is followed by a 
double word 424 which contains a controller identifier. 
The packet is concluded by a single word 426. The 
higher-order byte 426A of word 426 contains an error 
code. The lower half of word 426 is broken into a pair 
of 8 bit fields 426B and 426C. Field 426B contains the 
controller’s hardware revision number. Field 426C con- 
tains the controller’s software, firmware or microcode 
revision number. 

Submitted as Appendix A hereto is a listing of a disk 
class and port driver which runs under the VMS operat- 
ing system of Digital Equipment Corp. on a VAX- 
11/780 computer system, and which is compatible with 
a secondary storage subsystem according to the present 
invention. 


Recap 


It should be apparent from the foregoing description 
that the present invention provides a versatile and pow- 
erful interface between host computers and peripheral 
devices, particularly secondary mass storage subsys- 
tems. This interface supports asynchronous packet type 
command and response exchanges, while obviating the 
need for a hardware-interlocked bus and greatly reduc- 
ing the interrupt load on the host processor. The effi- 
ciency of both input/output and processor operation 
are thereby enhanced. 

A pair of registers in the controller are used to trans- 
fer certain status, command and parametric information 
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between the peripheral controller and host. These regis- 
ters are exercised heavily during a four step initializa- 
tion process. The meanings of the bits of these registers 
change according to the step involved. By the comple- 
tion of the initialization sequence, every bit of the two 
registers has been checked and its proper operation 
confirmed. Also, necessary parametric information has 
been exchanged (such as ring lenths) to allow the host 
and controller to communicate commands and re- 
sponses. 

Although the host-peripheral communications inter- 
face of the invention comprises a port which, effec- 
tively, is controller-based, it nevertheless is largely lo- 
calized at the host. Host-side port elements include: the 
command and response rings; the ring transition indica- 
tors; and, if employed, bus adapter purge control. At the 
controller, the’ port elements include: command and 
response buffers, host command and response ring 
pointers, and the SA and IP registers. 

Having thus described the present invention, it will 
now be apparent that various alterations, modifications 
and improvements will readily occur to those skilled in 
the art. This disclosure is intended to embrace such 
obvious alterations, modifications and improvements; it 
is exemplary, and not limiting. This invention is limited 
only as required by the claims which follow the Appen- 
dix. 


APPENDIX 


Notes: 


1. The mass storage controllers is referred to in this 
Appendix as “UDA”; thus, the IP register will 
appear as UDAIP, for example. 

2. The term “MSCP” in this Appendix refers to the 
high-level I/O communication protocol. 
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6LEF MSCPSwOUSLIFRAC ,SIe Ww 1 $ Use Fractior 

SLEF MSCPSuLTIMF eBLAL 2 : Quaaworn tire and sate 
SDEFEWD IJ 


+ Define Resnonse packet Uftsets = _Nul} Label ArnautentsS are Same 
$ as those aetined in tne Generic/Transter Command Packet Aoove 


SDEFIWwI KK 
»BEKEL 2 3: Packet Linkage long woras 
ebLKT. 1 : Packet Lenot” & Virtual Circuit Ti 
»BIAL 1 : Comnana Reference Numper 
eA KA 1 : Unit wurser 
e BLAS } ; Reserve: fiela 
o OLKR 1 7 Op Conde (also called enacode) 
SDEF MSCPSHoLFLAGO ebblrs { } Flags field 
SDEE MSCPSwoSTATUS ebLA« 1 : Status 
«bLAL 1 7 Bytes transfered count 
eSLEL 3 : Peservegn 3 loons words 
SLEtr MSCESLIFROTIBAL . BEAL 1 ¢ First Gad KRiacK 
? Software norids 
SLEREWD Ka 
3 Get Command packet End Packet Offsets 
SLEFIw I Lb 


Otfset (ice) 


=¥SCPSLILOUIIRER +4 
$DE F Comnand Status 


MSCESwLCMUASTS = oBIKW 1 
SUEFERD Ib 


3 Get Unit Status End packet specific Offsets 


were 


SLEFTwl MM 


e=MSCHSHOMODIFTER+2 3 Offset (12) 

SDEFE MSCPSwoMNLTLUNT ,BLKW 1 > Multi-Unit code 

SLEF MSCPSwLUNTLFLGS .BLAw 1 : Unit Flaqs 

SbLEF MSCPSLLHOSTLID = .BLAL 1 3 Host identitter 

SDEF MSCPSueUNITLID e6BLAL 2 ? Unit identitier 

6DEF MSCPSLOMEDIALIN .obal 1 3; Media epee identitier 
$DEF MSCPSaJSHUWLUNT J BLK} i ¢ Snados 


SUFFEWE 


Md 
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# Online & Set Unit Characteristics Fnd 


at 28 

SDEF MSCPSwoSHUWLSIS ,BLK« i ? Shadows Status 

$ DEE MSCPSWOTPACK SbLkWY oY : Track Size 

$DFF MSCPS4.GROUP oKLEW 1 : Groun Size 

SDEF MSCPSWICYLTNPER ,BLKA 1 ; Cylinoer Size 

oBLKw 1 : Reserved 

SvLEF MSCPSwoORKCTASIZF J BLAW 1 > RCT Table Size 

SUFFE MSP Ee SrnonknSs »oERtS 1 3 Feats ¢ tracer 

SLE MSCPSHSRCTOCPIS J BIA 1 ? RCT Conies 


Pacxet specific otfs@ts 


SULFFIWI Na 
e="OCESwoSHUK_LSIS4? 7 Ntfset (30) 
SDEF MSCOSLIUMTSSIZF , BIKE 1 : Unit Size 
SDEF MSCPSLAVOLASFRK  ,BLAL 1 7 Volume Serial Numcer 


SLFFEWD "te 
3 Set Cortroller Character{stics Ena nacket Specitic Ufisets 


SLFFTwI Ov 


o="SCPEWOCK SF LGS+2 +; Otftset (16) 
SDFF MSCrSwoCNTOGMU BLA 5 i Controller timeout 
$DEFE MSCPSH CNTACMOL SLRS J + Controller Conmana Limit 
SLEF MSCPSULCU1LAWID ePLKL 2 + Controller I.v. 
SDEFEnR Ov 
3 +4 
> Local symonl definitions 
te 
DEVICELOIPL = 21 3 Pevice JPL 
FUPRSIPL = R + Forn IPL 
LOOF.LImMI4 = *X<FAaun> * Step 1 taxinaun wait fime tor restvonyse 
INTRKOVEC = *0¢€270> * Primary interupt vector 
+ Nefine Initialization Sequence UNASA bit tlaqs 
INTToMASTEP 4 = *44090 ? Step 4 anaicator mask 
INITIOMOSTEP3 = *X2090 2 Step 3 anaicator mask 
INITIMASTEP2 = *A1V0090 3 Step 2 indicetor masx 
INITSMOSTEPL = *KRYN # Stevo 1 inoicator rast 
INITSKCINTI = *A48u ? Inictialization seauence interunrt enanle 
INITTSMOINIF = 4 ? Fnavole tatal error interupt flac 
INTIoMALE ATL = 2 # Reguest previous tallure loy messaie packet 
INIT OMOPURGE = 4 ? Fnaple purse tian 
INITOM.AGO = 1 ? Go tlag 
INTTAVAERKORK = °K : Initialization tError 
INIT .VeSTEPS = “AE : Step 4 inugicator pit 
INIT OVASTEP 3 = *Xxh ¢ Step 32 inaicator rit 
INITSVISTEP2 = *KC $ Step zZ indicator pit 
INITAVASTEPI = *XR ? Step 1 ingicator pit 
? Initialization Seguence Step word formats 
STEP.LeRRITE = <Le15> 3 <MSCPSKIEXPONENTA@L E> CMSCPSRIEXPOWENTOADLINITIMOINTI NT aT 
STEFS2AmnEAM = INTTO4LSTEP2I C1 eT > IE <KMSCPSKIEXPONENTS 43> IMSCOSK LEXDUNERT 
STEPLIZAREAD = INITOMISTEPSLINITIMIINTISCINTROVEC/ > 
¢ Command and Message Ring Control Flags 
UDALMIOwnK = 1831 : Own flag mask 
UDALM_LFLAG = 1839 ? Buffer control tlaq masK 
WUALV Ow N = *X1F 2? Oen flag vector 
UDBLVIFLS, = *X1F > Buffer control riled vector 


? Pirect MSCP Packet I/U Function Cones 


TOSLMSCPLPKT = LNs onOr 


: Control) Packet Upcodes 

, 

3 Command Opeode pits 3 tnru S indicate the comuand class; 

; Odu imneatate Commands 

; Q0%1 Sequential Commands 

; O10 nNOn=sequentsal commands that do nor include a ouffer descrictor 
: Q11 BPaintenance Commanas 

; 19U NOnesequential commanis that include a buffer uescrivtor 

s End packet Upcodes (also called Fnicodes) are formed py aadina the ena nace 
: flag (€20u octal) to tne correspondiny commana packets upcoue. Ar unKr 
t commana’ End pacxet contains Just the tlaq in the packet’s Oocode tielo, 
MSCPSKOUPSABORT = 1 ¢ Put, *49) ABOKT Command 

MSCPSKLIUPLACCES = to #7020, *X1U ACCESS Comtmana 

MSCPSRKIOPLAVAIL = B “Ulu, 7x08 AVAILABLE Command 
MSCPSKLUPLOMPCD = 17 #4021, *Al1 CUMPAKFE CUNTROLUER DATA Cominand 
MSCPSRLOPLCUMP = 32 : “040, 7420 CUMPARKE HUSY DATA Comnand 
MSCPSKIOPCFRKASF = Le 2 #0229. TALS FRASE Comnand 

MSCPSROUPLFLUSY = 19 O23, *413 FLUSH Comnand 

MSCPSKLUPLGICMD = 2 3 *u02, 4492 GeT CuUMMAwD STATUS Commana 
MSCPSKROUPLGIUNT = 3 3: 7093, *°x93 Crt ttntk STATUS Command 
MSCPSKIUPLORLIN = 9 : *U11. “409 ONLINE Commana 
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29 30 
MSCPSKAUPLREAD & 33 7 *041, *X2) READ Commana 
MSCPSK UPL REPLc & 2u $ “O24, “X14 REPLACE Command 
MSCPSKIUP eSTCON @ 4 # "004, “KO0Oa SET CUNSROLLER CHARACTERISTICS Comtan: 
MSCRSRIOPLSI UT = 16 # *012, “AKA SET Unt CHARACTERISTICS Commana 
MSCPSKIOPLHKITE = 33 ¥ *042, *K?2 WHITE Command 
MSCPSKOOPLEND == 428 3 *0208, *x80 END PACREL rLaG 
MSCPSKIUPLSEREX = 7 : *0O7 “x7 SEPIANUS SACEPTIUN EwD PaChekl 
MSCPSKCUPLAVAIN = 64 ' “cibo, "X40 AVAILABLE Attention Yessaye 
MSCPSKLUPLDUPUN = 65 - “0101, *X41 RUPLICATE WNIT wlIMBer Attention Yessaic 
MSCPSKIOPLACPIH = 66 5 *0102, *xX4? ACCESS PATH Attention Messayje 
MOCPSneUP MED = *xs8U fF End Packet Aask 
MSCPSVOUPLEND = y End Packet Ait Flaa 
MSCPSMLUPLAITN = “A440 fF Attention Message Command asp 
MSCPSVLUPLATTN = = 3; Athention Message Command it 
MSCPSV.OPLREALD = 0 + Read command pit flaa 
MSCPSVLUPLXFFR = 5 3 Pate Transfer type MSCP Opecode pit 
? End Pacxet Flags (mask values) 
MSCPSMLEFIBELKR = “X8Q 3} Bad Block Renortes 
MSCPSMLEFORSLKU = *X4G + Bad Rlock Unreportea 
MSCPSMLEFLFRLOG = *4270 } Error Loa senerated 
MSCPSMLEFCSEREX & “X10 Y Serious exceotion 
$ End Packet Flags (vector values) 
MSCPSVIEF I RBLKP Bad Block Keporten 
MSCPSVoEFIBBLAKT Bad Block Unreporte. 


MOCKS y EF LERDUS 
MSCPSV OEFISEREX 


BADD 


ew te seve 


Error Lot aenerated 
Serious e@#xceotion 


# Controller Flags (masK values) 

MSCPSMICFIAVATN = *X89 $ Enaple Availaple Attention Messanes 
MSCPSM_OCFO™ISC = *X4V ? Fnaple miscellaneous Error Log vessa‘les 
MSCPSMOCFONIHER = “A?U # Enaple otner nost’s Error Loa Messages 
MSCPEMICFITHIS = *X10 ? Enable this nost’s krror Log messaces 
MSCPSMOCF_USHALW = 2 # Snasowina 

MSCPSMUCFOSTA = j # S7Hh Byte Sectors 

* Controller Flaas (ras values) 

MSCPSVICF_LAVATE = 7 t Enaple availaole Attention Messales 
MSCPSVLCFIMISC = 6 3 Enaple miscellaneous trror Loy messaces 
MSCPSV CFLOTHER = 5 ! Enable otner nost’s Error Lo “Yessai*s 
MSCPSVICFITHT = 4 ¢ Enaple this nost’s Errer voz Messactes 
MSCPSVCCFIUSHADW = 1 ¢ Shagowind 

MSCPSVICF.576 = 4 * $76 Byte Sectors 


+ Status ana event Codes 


MSCPSMOSTIMASK = “ALE # Status / Event code Mask 
MSCESVISTIMASK = ff : Status / Event code (start of fielt) 
MSCPSSLSTIOMASR = S§ 3 Status / Event cone (ttels size) 
MSCPSAISTLSBCUD = *X?0 t Subecode myultiniier 
MSCPSKISTLSUCC = 0 : Success 

MSCPSKOSTAWITCMD = i 3 Invalid Command 

MSCPSAUSTLAGRTD = ? 3 Command Aoortet 

MSCPSAVSTOOFFLN = 3 ; Unit OfteLine 

MSCPSACSTOAVLEDL = 4 : Unit avaflabple 

MSCPSKUSTIMEMTF = 5 : “edia Format tLrror 
MSCPSKLST.WRTPR = 6 ¢ write Protected 

MSCPSKLSTICUMpP = 7 + Compare Frror 

MSCPSKRUSTINATA = R + Data Error 

MSCPSKISTIHSTBF = 9 : Host buffer access error 
MSCPSKISTOCNTRL = *X8 3s Controller error 
MSCPSROSTIOOKIVE = “AR 3 Orive Error 

MSCPSKRUSTLDIAG = °XIF ? Message from on internal diasmnostic 
3 Define wll Parameters CAP) offsets 

P1 = 0 ? First QIN Parameter 

P2 = 4 } Secona WI Paraneter 

P3 = 6 ? Third G10 Parameter 

P4 = 12 ? pouren Gtu parameter 

PS = 16 3 Ae QI0 Parameter 

Po = 20 + Six on Q1O Parameter 


eORTTL Tables 
AGE 


+ +4 7 
3 Driver Proloque Tahrle 
3 == 


UN LUADSUPAS UNTO 


NAMESDIUDRIVEP 


B, 


Driver Unisad routine 
Driver sere 


DPTAB - : Define Driver Prolog Tacle 

FADSUDALFND,= 3; End of Oriver 
ADAPTERS ea ¢ Unipous Adapter type 
FLAGS=9, t No Syster Pace reyguired 
UCRSTZESUCHSK. S1ZL,° 3 UCR Size 

; 

: 

® 


DETISIOKE 1 


NITg 
PPTISTORE DvP, PDASTLCACPL, Lp <* ANF 


Control) Block Init Valves 


2? Default ACP Name 


11\> 
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HETISIOnNS DOA, PDASLACPD4s,4 


32 


ACP Class 


NPTLSICKE UCK,UCASRLFIPL, FonK TPL : Fork LPL 
DPTISTORE UCRJUCASILODEVCHAP,L,= 3. Nevice Characteristics 
<pFVs4. FOb- ? Files Griented 
IDF V§4_vIR-= ? «6birectory Structured’ 
SpE VSML4&VLe 3 Avafilaple 
LVEVSMIS4R} $ Sharable 
fuFvySelldye 3 Input vevice 
TUF VS$SmouUDVe 3; Ovteut Pevice 
. 2 LF VSMURYD> + Kandom Access 
DETISIOKE ucr sUCBSBISECTORS,A 31 > RABU Sectors per trac« 
CPTISTOKRE ICR, sUCRSa— TRACK S25. ¢ RARO Trecas per cylinoer 
OPT.SICRE UCR, NCAgy. CYLINDERS $47 # RABO USer a@réa cylinders 
CPTOSTOKE UCB, UCBSRHODLYCLASS,6, besaorse 3 Device Class 
OPTS LORE. DCB, NCBRsw TDEVRUFSIE,¥ 3: Default Rufter Size 
DETISTORE UCR, UCRSR_ TRIPL, BO DESICEATEL ¢ beviee LBL 
PPTISiORE UCR,UCBSNUSTS, 4, NCAS¥. OuLINe 3 Set units online 
DETLSTORE UCB,UCSswal PeVSTS,«, 
<UCRSKUNOCNYPT~ ? No UB to onysical ador conversion 
SUCHSM_DTAGBUF> + Diagnostic putfer specitied 
Nebo ~STOKE UCB A UCASLA aVMAXSLUCK, Lee 3 KAED Yax Los 
DET. STOKE RETNIT 2 Control Rlock ReelInit Values 
PPTLSTORE PoB,DUPSLIDNT,P,DUSUL] 3; vriver Dispaten Tapole Adar 
OPTLSTORKE Cre, CRESEOT: aT {ie #4,U,- 7? Address of interupt service routine 
DALINTERUPT 
PrTCSTOKE Foe 


2 +4 
; Driver Oispatch Table 
$ ©. 


DLT AP - 

Du,- 

Woks raRTiO,- 
ba FUNCTARLE,~ 


0,< 
wSCPSK-PATSIZE+12,~ 


? Internal gata structures 
UDASLIINTeRNAL: .BLKR UDASKISIZE 


30 Se Se we Se te wa Ne 


Device Nane 

Start 1/9 routine 

No Secondary Level Interupt 
Functinn Lecision Tarle 
Cancel I/u 

Frror Loaygina Routine 

Piay Butr byte lenatn 

Size of error bufter 


eS81TL UDA Function Lecision Tahle 


eo PAGE 
3 + 
; Driver Function Pecision faple 


UDALFURCTABLE : 
FUNCTAFR ‘ 
Or 
witLALIZE, = 
EEK 
SE. 


SiChak,~ 
ExSEMUDE,= 
SETMURE, = 
SEICHEAR,&= 
KEADLELK,-= 
KE aDPRLE,= 
KFADVALK,@- 
wRITELGL&K,@ 
wKITTEPslLe,@= 
fcéeseren 
ACCESS 


DELETE 7 
MOUIFY,< 
MOUNT 
KFACHEAD,= 
wRITECHECE, = 
eFITERLAD>. 


.- 

<SEwSECHAK,© 
SFwStE¥ODE,= 
SETMODe,= 
ocapbate” 


ACpCORIRUL, - 
CREATF,= 
DFACCESS,= 
LELETF,© 
MOUTFY,= 
MOUNT> 
FUNCTAB UDALFDTLINIT <InTrTAblZe 
FUNCTAR UDA_FuT-TESTONL, = 
<nOp 
REABLBLK, = 


FUbCTAR 
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Ledal Function 4asks 

Virect MSCF Packet Function 
UbA and units initializetion cotta 
Seex 

Sense Cnaracteristics 

Sense “ode 

Set ode 

Set. Characteristics 

Reaa Lovaical plock 

Reau Fhysical BlecKk 

Read Virtual slocK 

write Loci¢tal BiacK 

write Povsical sdlocKk 

write Virtual Alock 

Access tile and/or directory ertry 
ACP Control Function 

Create tile and/or directory 
Neaccess tile 

Delete tile and/or airectory 
Modify file attrioutes 

Yount Volume 

Reao head 

brite Cneck 

write Head 

Buftereu 1/u Funetlons 

Sense Cnaracteristics 

Sense Mode 

Set Mode 

Set Cnaracteristics 

Access file and/or airectory entry 
ACP Control Function 

Create tile and/or directory 
Deaccess file 

Delete rile and/or aflrectory 
Modify ee attributes 

Mount Vo 

: WDA Th evalieation 

Test LDA tor online 

Direct MSCP Packet Function 
Peas Lojical s#)ock 


FUNC 
FUNC 


a4 
PY 
ry 


FUSCTAR 


FUNCTAR 


FUNCTAH 
FUNCTAS 


PUNCTAR 


FUNCTAR 
FUNCTAB 


[Th 
Ge 


ed 
ef 
eRNASLE 


++ 
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READPBLK, 
BEADVBLE 
SFEck, 

eR ITELBLK,= 
wRITEP BLK, = 
cel TE EUNee 

CCESS,= 

APBCON TROL 


.? 


a 
2 
tT 
» 
~ 
7” 


~ 
4 


CecsexEzecc 
PPUDMOIs 
Li rerecres 
BAH Sa 
COMMIS AH 
SA LOR <M 


ACS 


RY 
RFADUPLK, 
KEADPRLK, 
READVBLK, 
wRITELSLA,© 
wRITEPSUR,© 
wRITEVBLK> 
UDALFOTIPHAYSI 
<KEADPRLK 

aPITEPALA> 
UDALFLTINUP,&= 
<READAFAD, = 
SErk, 
SRITEHEAD, = 
wPLTECHECK> 
+ACPSREANSLK, 
CREADLBLK,= 
READPALK,= 
KE ADVALK 
*aACPSaPit 
CwRI 
wR 
wR 


Ve aaune 


> 
EKLK 
Kye 


Loe 


(ae 2oneee 


ano 


, 
“A 
vb 
c 
’ 
> 
U 

aA 


* 
’ 


a 
C = =e, TOO TUTNTRH 
RAADM WB AT} DRAW NH 39-3 
Gry 2sNACROG SMe 


£ 
prasne 
SFTCHARD> 


FuT Poutines 
LsR 


. 


Functional Description: 
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7 


t> 
»SVEACCESS> 


Refer to specific FvoT routines. 
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sexe 


we te 


34 
Read Physical Block 
Read Virtual phlock 
Seek 
write Ibocical Blocr 
Write Pnysicai hlock 
write Virtuel Block 
Access file and/or directory entry 
ACP Control Function 
Create tile and/or directory 
Deaccess file 
Delete file and/or Jiree tory 
Modify tile attriputes 
Mount Volume 
Reag nead 


write Cneck 

write Heau 

Pirect MSCP Packet 

Fyen pyte count redqulrea ftuncttions 


Reavy Loyicaj] nmlacK 

Read rhysical Biock 

Reaq virtua] plock 

write Locical Block 

Write Pnysical block 

write Virtual Block 

Pnvsical if request tunctions 
Read Fhysical Klock 

Write Dnysical plocK 

No operation tor current version 
Read xead 

Seek 

Write Heaa 

write Cneck 

ACP Read Functions 

Reau Loyical plocl 

Read Physical Rliack 

Reaa virtual clock 

ACP write Functions 

“rire Loaical Block 

Write Pnvsical alocx 

write Virtual Block 

ACP Access or create tile/sdirectorv 


Sense Cnaracteristics 
Sense “ode 


Set Mode 
Set Cnaracteristics 


3 
? 
? 
} 
t InPuts: (common to all FET routines) 
? 
3 R3 = address of IkKP (1/0 Kequest packet) 
; R4 = Address of PCR (Process Control block) 
' RS = Adrress of UWCS (Unit Control Flock) 
; Re = Address of CCR (Channel Control Block) 
3 R7 = Bit Number ot the I/7v Function Code 
, Ry = Address of the FLT Table entry for tne specitic FNr koutine 
? ap = address of tne first function ependent Alf Parameter 
? eau 
UDAVFOTITESTONL: 
MOVAR UDASLIINTERNAL,K2 : Get aadress ot internal Structures 
BLURS UDASWIFLAGS(R2$ lus ? Controller is presumeable online 
MOVL UDASWIINITAERR(R2),R1 + Loaa init error flags 
Ss: MUVZWL  #SSSISSFAIL,RO : Set suh-systen tailure status 
BRR 11%§ ¢ Finisn l/u 
1088 MUVL UCBSLICRACRS), RL : Get address or CRs 
“OVE CKRSLIINTUSVECSLCIDB(RO) KO | Get adiress of IDs 
MUVL (KO), RO 3 Get address of CSH 
MOVZWL UvASA(RO),RI ? Test 1f UDA died since last 3/n 
PEQL 19s 3 No 5 
BeSCc #UNASVIUNLIWE,= : Heses controller online and Finisn 
IDASWOFLAGS(R2),5S # T/n 
1563 BICw2 #UCBSHUBSY,UCBSwoSTS(R5) ¢ Clear unit busy to avoid a woil 
208: RSB : Return to Ex€soin 
oe PAGE 
a +t 
? ULALFUTIBYTeCAT 
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ULSlFiTo apie ; ’ 

#U,P2CAP),2uUS 3: Return if byte count is eve 
105s: MuVzwu asSsoivanften, Pu 2 Set oa nyte count status 
119s; Jp G*EAFSFINISHTIU : Finish 3/46 

eo PAGE 
. +4 
 ULALFLTO4ASCe 


UDALFUTIMsCr?: 


MOVE Get address of user’sS YSCr pet 


P1CAP),R9 : 
MuVE suSCPSk PaTolZFelz sk! 3 Loaa lenath of an “SCe Pkt ¢ neater 
DoBINL #sLPLSISiNC ? Synch access to system data hase 
PSBa HAL ALOASPAGED 3 Allocate oa svste™ bufter 
POE et } Return to previous IPL : 
RLaC RU,215§ 3 Insufficient resources, avort T/t 
MUVE R2,IFPSLOMFDIA(K3) i Load MSCP Pacxet pugfer address fn i- 
MOVE PlCaP),k9 : } Get address of user’s MSCr pEKt 
CLR. Ri 3 Clear tnaex 
200538 MOVu CKO) En1),120R2) R11 ¢ Copy mSCP pacxet into hola putter 
PURLSS #4SCPSKLPOKTSI ZF aed, KI, 2008 
Ros #MSCPSVIOPLXFER,&= 
MSCPSbeQUPCODF(R2),205S 3 Process transter 1/uU tunctions 
204s: Jp G*PEXFSGLIOR VERT 3; Queue packet to driver 
20588 MUVL MOCPSLIBNEFER(R2),PICAP) : Load xfer address in T/M parateter 1 
MOVE MSCPSLIGYTEWCWT(R2),P2CAP) 3 Load xter pvte count 
BEL 2045 > Tt’S a UDA seek command 
Bos @MSCPSVIONpPLKE AD, © 
RASCPSHIUPCODE(RZ),219S8 ¢ Opeode if a reaa class command 
209s: JMP G*EXFSwRITF : Process direct 1/0 «rite 
2198: Jmue G*EKESUDIF ys ¢ Process direct I/U read 
215s: Jnr G*FAFSABORTIO : Apart I7n 
a PAGE . 
i +e 
¢ UGALFUTLNUP 
UDALFUTLNGP: 
MoVG S*#SSSANIKMAL, ROD ? Set mormal return status 
aep G*EAFSF INI SH TOC + Funisn l/u 


Pe Se Ne te we te te He Ge te Oe 


++ 
UDALFUOTLPAYSTU 
This routine iS called when a Pnvsical 1/0 request was received, Ihe physical 
disk adaress in parameter 3 of the parameters Jist 18 canvertea to a lotica) 
block mumper, recoanizapnie oy tne VOA. ihe algorithm tor conversion fs: 
LoN = fecylinder * (sectors per tratn * tracks per cylinuger)) 
+ (track * sectors per track) 
+ sector 


ULALFLTLPRYSIU: 


<0 55 Se Te Ne Ne ue te Ne Ye te Se Se 


MUVZRBL UCKSRLSceCTORS(RD),8U : Develop LeNs/cylinder value 

MUOVZA], UCARSBLTRACKS(R5), #1 

MULL? RO,KI : Ril = LAWS/cylinder, ROU = cectors/tracn 

FARTZV 916,816,P3(AP),K2 : Get physical cvlinder value 

MULL? P2,R1 ; Multiply cylinder hy LAns/cylinder 

EaT2Zv th,eF,P3(AP),H2 § Get ehvsiJal track numoer 

MULL? Ru,kR2 ? quae to ly py sectors/track 

ALDL2 R2,81 + Add sector/tracK to apove 

RATZY 80,88 P3(AP),R2 ¢ Get pnvsical sector number 

ALDL? R2,ki ? result as the equivalent LB 

MUVL Ry, ITRPSUMMFDIACK3) 3 Stuft in Lyi area of IP 

CHPZV - ALAPSVOFCODE, #IRPSS.FCODE,- + Ts this a reaa ? 
TKOSKLFUNC(KS), #TSREADOOIN 

ALOL 2193 3 Yes, goto Bee ened 

BKR 209s 3 Goto EXxc$aR1T 

o PAGE 


++ 
WOALFUTLINIS 
Functional bescription: 


Tnis routine 18 called when a hard initialize ot tne Uva is pe raueers i 1 
baSically mimmiecs tne tunctions of the osY¥SGiN process a loasing tn: 
aenteaee renisters with the values tnat SYSGEN woulo mornally Joad. lL 

adition it disables all interupts and calls tne eee level ou 
initialization routine. uPon return to tnis FOT routine, orfginal FN1 conte: 
is yeeroneee interupts are @napled back to around 0, and tne I/9 request 3 
terminated. 


UDALFUT. 


Dxzee 
-“ 


Gcocccmns 


L£ecaqcynpes 
eOccc tee 


@w@T UO 

zazc 

yas 
mx 
=z 
4 
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? Disable 4a]1 interupts 

,Ra> * Save FOr Context 
a ; Get address otf CRo 
o Load K& with addr of LNb 
Le IDBCHRD ERS ? Get address of fb 

oad CSn address in P4 
ée ana injt the Upa 
Restore FUT context 
Enaole interucts 
Finisn the I/u 


we tone cane 


ULALFOT.NUP 


eDISABLE LSu 


oS ITL UDACSTARTIO © UDA Start I/0 routine 
e &G 
% +¢ 
, UDALSSTAKTIO = ULA driver start I/u routine 
* InPuts?: 
; R3 = Address of I/C Request racket 
; RS = Adagress of specified Unit Controg nloek 
° 
? Pegister assignments: 
z PO = Address of “SCP Packet 
, Ri = AduresSs of internal data structures 
; R2 = Adsress of Active MSCP Packet list entrv / . 
: P3 = Address of IkP or Internal Packet oeing services 
3 R@ = Genera] work Reanister 
; F5 = Address of indut queue end forx blor« (clone) UC 
: Po = General work Register 
} R? = Seraten 
! Rs = Seratch 
eENABLF L&R 
UDACSTAKTIO: 
MUOVAR ULDASLIINTERWAL,+1 : Get aadress of interna) nufter 
MUVL UDASLICLOWEUCHK(K1) »e2 3 Get address of JP queue Cr 
MUVAA UCBSLIIUQFLE(R 23,82 $3 Get aadress of queue listread 
FUuSHL Ri 3 Save internals putfer address 
JSk G*EXESINSERTTRKP ? Insert 18&P in inbut aueve 
PUPL Ri 3 Retrieve Internals ouffer aaudress 
UDASINTERWALIIOS : Reference Latel for internal “SC 
t Packet yuevueina to UDA @ tork TST 
PUSHR #°¥<Ro,K?,RO> 3 Save rejyisters: 
MUVL UDASLCLOMEUCK(K1) KS  $ Get aadress of clone ute 
5s: JSR Ger etal s ACKET 3 Get next enpty Consany pacret 
RRS @VASVISYSTEM,RO,65 ? Got one 
BR w 558 3 Rings are fuli, close out 
6s: MOVL- UDAST. TWTPQUE (RAID, RS $ Get address ofr internal aueyn lisths 
PeMsUe @(F3),R% ¢ Get next interna] nmaccxet tor une. 
RVS RS $ None tnere, trv outside I/% request 
CURL Pts ? Clear inder 
ss MUVE 12084) 089] ,MSCPSLICADIREF(ROV(Ro) ¢ Copy packet to rina buffer 
AGRLSS a&MSCPSKPATSIZEes3, rKA, TS 
MUVL MSCPSLICMDIREF (RO) 3 Cony command rerence nuaper into 
CPKESLICYD REE CR)" $ Active packet list entry 
BISw2 #UNASMPQUEL, UDASWoOFLAGSC( RI) § set a packet was aueued tlat 
JSB ee uae $ Queue Packet to UDA 
MOVL R4,RO9 3 Get audress ot temporary cutfer 
BSBw UVALDEANONPAGED 3 Rewallocate systen butfer 
InCbL UCRSL.OPCNT(RD) 3 Account for queued 1/u in Clone UC 
ReB 5s 3 Start again 
Bg: MUVAB UCRSLIIOOFL(RS5S),RG¢ 3 Get aadress ot 12p qusie listnedd 
CPL CK4),R4 3 Is the queue empty 
BEQL 318 3? Yes, exit 
MOVL (m4) ,83 a 3 Get address or IKp to process 
MOVE IKPSLIUCB(RS), ? Get attress ot aSsaciated HiCK 
TSTa TRKP SWLFUNC(K3) : Is thas a tirect aSCF packet I/u 
Br&y iss * No 
MOVE TkKPSLIMEDIA(RI),F7 3 Get adtiress of packets ten storaie 
CLRL Re + Cleer index 
106s MUVGS 120K7) (RA), MSCPSLICMD, eee og tes} 3 Copy packet to ring pufter 
Ove 120K7) CRO), CPKFSEAUSERSEF(RZI(RG) 3 and into active pet list 
ADRLSS smscpskPrtsiZee-3, R8,1U0S 
eS #MSCPSVIOP. 
MSCPSnHeUPCN forces, 118 : Process data transter “SFr pkt 
apa” cata anlaaae 3 8@ ckeecx tor abort of aet emda stst 
rf u 
1183 TSTL MSCPSLIOBYTELCAT (RY) : Is this a seex packet byte count = 0 
Bey 258 2 No 
RRR 4us 3 Yes, wunevue packet 4s is 
158; MOVE eMSCPSKIOPAREAD,R7 3 Assume a read function 
CMPZYV MIRPSVSFCODE, sTRPSS.FCODE,©= 3 Is it really a reac ? 
TRPSWLFUNC(RS) - 8 TUSSREADPDLK aur 
BEQL 20$ ; Yes 
MUOVD BMSCPSKCOPoARITLE,R? + Load @ write of cote 
2083 MOVE R7, 4SCPSRONPCUNE (CKO) 3 Loag on code in command paetcet 
MOVE IkKPSLCMENTA(R3),~ f Loag unt 
MSCPSLeLAn (RO) 
MOVe UCKSw HINIT(R6),2 ¢$ Loaa Unit Numoer of associates uCh 
WSCPSWeUNIT(ROS 


25$: 


a ll 
ry -oO 
wn men 

econ 


408; 


458; 
508: 


S563 


608: 


6583 


MOVZWL 


BEOL 
PUSHR 
MOVG 
JSB 
RLAC 
JSR 
PLAS 
JSA 
POPE 
TSTi 
RRR 


RSRa 
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IRPSWIRCNICK3) = + Load transfer byte count 
MSCPSLAUYTEW Cif (RU) 

40 ?.No pyle count, seek only 

** m<RO : Save reyisters trom destruction 


IRPSLO gt AbT 2nd ue S$SueSVAPTFE(R5) 3 Load xfer parameters in UC% 


Bo Geert Oa AAR ae 3 Request a puffere®s aata ratn 
305 3: Nome avaeflaple 
G*4esauourasar : Allocate URA mapping reaisters 
RO,355 3 Goog return 
G*TOCSRELDATAP 3 Release buffered data patn 
#*M<KRO,RI,R2,K4 7 Restore reaisters 
(SP)+ ¢ Clear return adaress to queve cmd pat 
$5s 3 Clean up and leave 
G*LUCSLUADIUBAMAP : Load JUBA mapping registers 
@*M<CRO,R1L,R2,R4> : Restore registers 
NCBSLIECKR CE S$ ,RI ? Get address of CRr 
CRASLoInTOoVECS ne 4APREG(RI), = ¢ Save URA Mapping context 
CPK ES aw MAPREG(R2) ¢ in active packet List Entry 
TkPSW.ROFFCR3), RA $ Kyudae uo xger ad4iress tor UDA 
CRRSLIINTD4VECS woMAPREG(RT) ,89,89,R 3 Load man register nur 
CRBASLIINTDS+VECSHSDATAPATH(R4),&24,88,K9 3 Load Data Patn 
Re, MSCPSLBUFFER (RO) : Stutf in SCP command packet 
R3,MSCPSLICYDIREF CRO) : Load IRP address as reference numprr 
R3,CPKESLICMNLCREF (R22) : in MSCP Pacxet ana List Entry 
a $P)4 3 Queve packet to UDA 
at eer eres 3 hs tnis a airect MSCP 1/0 
7 No 
IKPSLIMEDIACR3), 3: Get address ot temmorary vouffer 
NDALDEANONPAGED 3 Newallocate system puffer 
FUDASMSPQUED ,UDASWHCFLAGS(K1) 3 Set a packet was queued flac 
UCRSLOpCaT(RS) 3 Accownt for aueuea I/u in Clone tick 
@(R4),R3 ' Remove [Fr trom tnput aueuve 
55s >; None left, prepare to leave 
Ss + Process next LRp 
B°UCKO, RI, Rbo> ? Pestore resisters 
: ? Olsabie a1] interupts 
sUDASV.CLINKED,= ? Link clone in witn UCea Jist ir 
Poet ar BAGSCRLD.S bs 3 tais is tne first 170 
SUPASV_PQUED,< 3 Alert UvLA of 2 cue? MSCP packets 
NDAs FLAGS(R1) 608 9 if que flea 18 set 
UCASLINPCAT (RS) 3 Are tnere anv unfinisnes 1/4v? a 
628 # Yes, allow for possible UvA meozt * 
UDALMOSTITINEK s Set host timer ans return co" callie: 
DASLLUCB.ZERU(RI ) Get eddress ot Host Timer .UCEN 
UCBSH TIapbcugensts tne} Clear timeout hit 
CRSLoeRB(RS) 3 Get acdress of UPAIP 1/0 page 
RSET InToeveCsLatDula4) KS y Teaiscer avoiding indirect 
e4),R4 3 reference 
va1P(Ra) s Initiete boa. Pollin 
VASV.SYSTEM,= 3 Take kS8 exi gf clone is eiready 
CASLIFPC( RS), 658 3 in the fork Sa 
3 Reset IPL to fork’ level 
3 Return to caller = 


SUDASM INTEXPCT, UvasaFLAUS(R1) ¢ Set interurt expected 
Ups. TiReouT, a3 
3 Create a fork process 
? Reference label for unsoliciated interupts 


R4,R1 : Copy eddress of interna) butfers 
UCAsLFPC (RS) 3 Clear fork aisDatch address in UCo 
6*<RGE,RT, RED 9 Save rejisters 

UDALFINISHIU 3 Close out end packets 

5s i Try to queve nes packets pdetore exit 


UDALFINISATO = Close ovt I/u routine 


© UDA driver I/M ecloseont rovtine 


Address of pnternel data structures 
Address of CLone UCB ‘ 


ress of End pacwet being processed 


Address of assocjatea Conra.1a Packet List Entry 
Address of a&ssociated IRe 

Scraten and 1/0 Status aroument register 
Scratecn and 1/0 suo status sraunent register 


cet EaDIPACKET s Get mext end packet 
3 Did we get one ? 

105s 3 Yes 

VASV8USTE 3 Return to caller 

OVASV.S2 EA,e 
MSCPSLAC¥D REF (RO) ,1098 7 Process JKP 
UDASW_FLAGS(R1), 1008 s Skip internal pxt it UDA is offline 
UDB PROCLINTRIL * Process internal packet 
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41 42 
100s: DECL UCBSLCPCHT (RS) § Account for 1/0 in Clone uCh 
BSRa UDALRESETIRINGS $ Reset rings to proper own state 
BKB UDALFINISHIO $ Go aaain 
109s: MOVL MSCPSLICMDAREF(RO),R3 8 f Get address of IPp 
zeae GURESAORAPREGCKZ) Ae ners UBA resources acquired ? 
PUSHR 8*MCRY,R1 ne R3> : bove current context 
move GeuEss haspee tea) [onc Sak aapSing'context into Cem 
a 08 mapping contex o CK 
CROSCTNTDOVECS Hak ek : 
JSA G*TUCSPURGNATAP ? purge buffered data patn 
JS8 G*TUCSRELDATAP 2 Release Bufteres pata Patn 
JS8 G*TOCSRELMAPPEG t Release UbA Maoping Registers 
Lira “oO ? 4t5et insex 
11583 MOVG MOCPSLILCYDOREF (KO) (K6),( Ro) (RO) 3 Copy ena packet into 
AUBLSS WRSCPSKOPRTSIZEG=3, R50 1155 ; dlaanestic mnuffer for user 
4 MUVL CPKESLLUSERREF(K2),(86) ¢ Restore user’s reterence miuther 
12083 InSy feu $ Load Eng Pkt Status for 195% wors ] 
e ’ 
CMPZV #mMSCPSVISTOMASK,© was tne I/1 successtul ? 
: #MSCPSSLSTOMASK ,MoCPSae STATIS(RO) p MSCPSK OST OSHCC 
BNFG 130$§ W 
MuVe @5SS~NOKRMAL,R? ? Load Success Status for TuSs eord 3) 
MOVL MSCPSLIBYTELCNT(ROD,P4 ¢ Loaa syvte Count Field for JuSe Lew } 
125s% BSR UDALTUPOST : Chose out the I/N 
BSBa UDALRESETIRINGS ¢ Reset control flags in rinns 
BW UDALFINISHIU ? Process next _end packet 
13083 Move #SSSDEVREQERR,R? ¢ Set failure Status 
CMPZV ®eMSCPSVISTIMASK,@= : Nid tne unit go otfilne ? 
&MSCPSSISTO4MASK,@ 
MSCPSWIOSTATUS(RO), @MSCPSKIST FEL 
Bn Fi 125s t No, return device request error stat 
MOV« #oSS.VEVORFFLINE,R7 $ Loaa sevice otfline status 
TSTa MSCPSW.LUNITC(RO) : Ts this Unit 0 
BEQL 125s : : Yes, leave it alone 
MOVL IRPSLIUCR(R3),Fo : Get aadress or uUCH 
B1Cw2 #UCHSMOUNLITWE,&@ 3 Clear par tne Flaq in uCb ana close 
BCASWISTS( RO) f out tne 1T/ 
BRR 1255 
ebDISABLE LSB 
UDALPROCLINIKNES + Process internal packet 
: Inputs: 
} RO = Address of Fnd patxet neing processen 
3 Ry = Address of internal data structures 
} P2 = Address of associated Command Packet List Entry 
MOVZBL MsoCPSB.IPCODE(RU),R7 bsk MoCP packet end code 
CHP RT, SHeMSCESK _OPLONLINIMSC sk SpeENo> fg o1s if an ONLINE end code 
EOL $ 
CHP ES R7, a <HSCP§KOP-GTUNT IMSCBSK OOP -END> 3 Is it a get unit status? 
BREu 35S ¢ No, ignor it then 
$ Get address of UCsh corresponding to Unit humber {in mSCP End pacxet 
Ss: MOVL ULASLoUCB. ZERUCKL) Get aadress of UCn vu 
108; Crea UCKSW ZUNITCK3), pe eees uwtt (nd) y Are unit nunoers tne sate 
PEOL iss Yes 
MOVL UCRSLILINK(K3),R3 * get aadress of next {ICP 
BNEW ius : : Try this one, 0 = last uCr 
RSB : Not a notma] unit numoer, ftanor it 
1583 CmPu R7,8<MSCPSKLOPLIGTUNTIASCPSKIOPLENU> 7 Is it a get unit status? 
BeQ. 308 ¢ Yes, proceSs it down stairs 
MOVZWi  MSCPSW.UNITCRO)D,R7 3 Get unit numoer 
BEGL 2us : It’s Unit zero, do not mark offline 
: Set other tnan unit zero ofteline until receiet of a success oF1 LIT SIAL’. 
3 end pacKwet 
RIC#? FUCOSMAUNLINF ,UCASwe S£S(P3) 
2u8: BiCw2 #*CCMSCPSHOSTOM ASHI, ? Ts retirn status success ? 
MSCPSWOSTATUS(FU) 
BNEw 3558 a) 
MOVL MSCPSLOEUNDESIZF(RuU),@ 3 Loay max LAN value tor system use 
UCBSLIMAXYBLUCK (hh 3) y into uCs 
PUSHR #*°"<cRy,R1,R2> * Save context 
+ BSBs UDALGETTWTRKT 3 Make a get unit status commana Pet 
BLAC RO,255 ¢ Allocation ftailure 
MUVe R7,4SCPswoUwIT(kK?) * Loaad unit Numper in packet 
POVE SMSCPSKCOPLGTUNT ,ASCPSRIMECUPE(K2) ¢ Load get unit stetus 
MOVIL, UDASI.-INTPOUF(RI5,Ri + Get internal pet queve listnea4 
ALUPL2 5*#4,R1 » Address tne hack link 
TASOUL (K2),eCR1) s Insert in rear of queue 
25s: PUPk eVcRuU RL, R 2D : Restore original context 
RSR s: exit 


: Process the GET UT STATUS “SCP BENd packet. 


30S; BICn? e*CKMSCPSMISTIMASNRD,& : Is return status success ? 
MSCPSHeSTATUS( RU) 
RBnFy 358 : No 5 
BLSa#?2 SUC HSMOONLINE, UCASH_STS(FR3) ¢ Set unit’s UCy status to online 


3583 RsR 
CHECK CAnOKT? 


CMPb 


5s! NUOVL 
1083 


1583 Ab 
2083 RSB 


eSRTT 
PAGE 


ws Se se 


InPuts: 
Ry) os 


State we 


DALHUSTSTIME 
YVOVEL 


1083 


208; Rs 


eSRIT 
RAGE 


+4 
UpALTIMENOLT 


a 


+ Flush 
MOVL 
4s: REMOU 
PyS 


bu 
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43 44 
ent disk geometry of sec erence lingers is enua a 
track/graup/eyi inser Aefinitions. alore devices tenn 
o tne four dimensional hvper= cuve arenitecture detine.: 
isk MSCP spec, whitn will invalidate the tollowing core, 
MSCPSacCYLIbWNER (HU), = % Loan C\ der t Ch 
UCRSWAEILINGERS (3) Yiin 5 value 4n TIC 
4 ow P(R - 1 
UERSATFACKS (BS) oad tracks value in ub 
MSCPSH. K(K0),2 7 ot dog ‘ 
HR SB SECTORS ERAS oad sectors value in cK 
+ Return 
¢ routine acded $/15/a1 re nandie reference m 
: aport 4nd get command status test. renrs TUE LSet 
MSCPSb.UPCODF(kU),= 2 I h 3k é 
PAS ePeRCAB REOAT ’ 8 this an APGR1 command 
PScps OPCOVE( RO) ; re 
A, 13 7 : s th aet iG 
shSCPERAOP-GTCMD ’ ; is a aet cmd status 
v0 , No, return 
PEASE REMC SEL ST ARN en? net aourees ot commana list 
© @ar loop counter 
CUKcse UNEeLES IL g3F ; pocerual packet or none at all 
eSte - 3 Are “SCe re enc b 
HSCPELIDUL REF CHO) reterence numbers equal 
» NO 
ae NSCP eh DUTIREF (RU) ; bao internally assiqned re: num 
; eturn 
S*#CPKESK ISIZE,R? ¢ Potnt to next c14 list entr 
12,F8,19s ; : Lonp throuvan List 


ULDALHOSTLIIMFR = HAST to UK Timeout handler 


++ 
UDALHUSILITAFR © HOST to UDA Timeout nandier 


Adaress of Internal bata Structures 


res 


u 


address of internals 
dress of UC» u tor nost tive 


Ts 


VvA is tlaqgea offline 
ress or Clone UC& 

VT queveinga pecKxets ? 
a 


td wut 
22a 
3am 4mnn sw 


t 
cz um * 4H DOAN 


ve Oot 


ve 

Make a 7c tork for syncronization 
Get an internal ae 

None around, too ha 

4eke a vorNp (PoUSF) UDA commen 
Unit 9 

CNyt{e2) 7; Load a boaus byte count 

Save current uCoe address 

Load an yue packet to Upa 
Restore input UCB 

Return to fork dispatcher 


40 ter a 


ROVE PUNYN DIP pP- 
~CTIPEVONL BS BOK OX 

ont &# 
roe 

cm TH AOe 
—nc 
qpa 
TRL 

me Wa Se te ve Va we te sets Sete 


25 


9 UVUD eH NDP 
43 3a x 


aAcUAKe VSONCOCHK =v 
‘ 
u 
x 


CCH MET ICNCOCCTH 
44m BTIAM CrzecTe 


s eG SE HOME 


Up. 


sete Nese 


UDALTIMEOUT * ULA titreour hanaler 


oa Command Tameout Yardier 


4a = Address of ‘IDALP 
5 = Address of Clone TICK 


UDALIFCR4) + Reset the UDA 

UDASLIINTERWAL, HI : Get aadress ot internals 
SUPASALTIME GUY PUDASHIPLAGSI RI) ¢ Set timeout flay 
#<ULASMOONLINE SUDASMALNTFXPCT?, - 3 Reset iunterupt expected 
UD&aSholPFLAGS(R1) ' and ipa’ aniine flaqs : 
UDASLIUCBLZRRuCK1), RO * Get address of nOST timeout UCR 
B*CCUCRSMLOWLINE>,© : Clear al} status pits in UCk vu 
UCBSW.STS(RO) 3 with the exception of Oh LINE 
G*EXESFORK + Synch driver at fork IPL 
UCRS#®ISTS(R5) : Clear al} status pits in Clone UCn 
UDASLLINTERNAL,&1 : Get aodress ot internals 
#°MCRO,RT, RED 3 Save work reaisters 

UpASFIAISATO : Close cut end packets if any 


ternal Packet Gueue 


Get aodress ot internal vacKet que 
Get next internal wait packet 
Queue is empty 

Return butfer to svste™ 


UDASLLINTPQUF(R1),R2 
eee tae 


s 
UDALDEAWONPAGED 


we ve sete 


SeFIKPCH for eventual Liter i 
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45 46 
BRE 4s + Loop until queve 18 enotyv 
Ss: CLEL R2 } Initialize loor counter 
WOVZWL &SSSJTIMFOUT,H? 3 Loaa primary I/u error Et Stus; 
3 Rundown a]11 I/N’%s tnat were apr eecy S queued to tne UbA brut were never: 
* terminatea via an Fnd Packer tnose MsCe Packets in tne active - 
3 list not closed out py the Fratsath Toutine). Internal packets are jonorec. 
MOVL UvDASLICMMLISTCK1) KS ¢ Get address of active end ligt 
108% Bot #VASVISISTEN 3 Satp oop ry or internal caches 
CPKESLOCMOCREF(R4) 158 ¢ Cancel only unfanisnea IPrs 
pose CECE SA RsAPTEGCH EI 90 ; Were URA resources acquiret ? 
3 No 
PUSHR BAMERE H4D ¢ Save current context 
MOVL UCBSLoCHR(P5),R3 } Get aairess of CRp 
MUVL RY, CESSLIINTDSVECSWIMAPHEGC(CR3) 7 Load mapping context 3m Cris 
JSR G*fdcseuRGnDATaP ? Purge bufteres vata bath 
JS G*1UCSRELDATAP > Release Buftereao vata Peatn 
Jse G*TOCS&CLYAPREG ¢ Release Una Yacooing Peaisters 
PUPK O*MCRL,R4> : Sestore previous context 
1183 MOVL CPKeSLICYUWKEF(K4) ,R3 : Get aotress of Rr 
MOVE R4,R0 3 Copy wee packet address ror 4yocas 
SUPL2 $*#4,k0 : Fovate “SCP oxt oftsets te enn list 
BSBB UDA. {UCAK : Close out the Ine 
158; ADPL2 S*aCPKFSKISIZE # Get aodress of next Facket 
ALRLSS SCPEE Or LT otecee a2, lus : Cneck ail] Command patcets 
f Rundown 81] IRPs that are still in the UCo Re List. [hese were never 
$ initiated at all. 
MUVAR UCRSLIJOQFL(R5),R2 3 Get address of input ike Queue 
2083 ReMuhe wae s Remove next InP from queue 
BVS 30$ $ Queue fs empty 
MUVL TRPSL OMEN LACR3),RY * Get macxuo bacret it any 
ASBr MWDALTUC A 3 Cancel the 
Rae OVASVISYSTEM,RO,2U$8 : Close out next IRF 
Aska UDACDEANONPAGEN’ 3 Return outfer to system 
BRE 20$ 3 Continue tor ali outstandie3 Jers 
3085 CURL UC8Sst PCT (RD) 3 Clear I7M count £1414 in Clone uC 
ot a*¥CRO,ZRI,RO> 3 Restore work rejisters 
> 
ePAGE 


++ 
UWDACLUCAN © 1/0 canceller routine callea ov the Timeout Hanaler for 
internal 1/uU rundown of IrRPs ana SSCP End cacKxets. 


2 se Sete 


; caput se, ws address of untinisnes ASCP Pac 
B ° e 
3 R}-= Address of Re meena Senet 
: a RI ws SSE.TIAEOUT status 
UDA.TOCAN? 
BoC OIRPSV_VIAGBUF,= 2 Sip meat? it, this was not © direct 
1kPswoBIS(R3), fos i 
83862 euSCPS¥..OPLENL, © 3 set ene cece. thea in packet 
NSCPSH Becbpe chu 
MOVe guscesksSTgCutae ° 3 Set controdier error return stetus 
3 es 
mov. BinPSLcoLacbireHS) Ke 1 Gee eoarets ot putter’s date area 
Sst feS MSCPBLACHL REF CRO) (K6] ches R85 5° y ene eeexes into 
GHLSS enSCPSKoPh ESS zEa-3,k5, 58 eats By Suk or user 
ae. 156 8 Close but 
1083 ru RO t gee no syster A ae fia 
1563 LRL ke s Clear secondary 1USp tons Wors Value 
Sxu UDA.TUPOST # Close out tne JeP and return to cell: 
Rit UOACINITIALIZE = UDA Initialization 
e 
3 @¢ 
: UDACINITTEALIZE © Primary Level UDA Initialization Rovtine 
2 Functional veseription: 
3 /TRS/ , 
# IPL Level © Powertai) IPL 
§ Inputs: 
t R48 Address of tne Cs® CUDATP) 
' PS 8 Address of IDR (interupt Data gsloea) 
’ Ro & Address of DOB (Device Pate block 
; QB s Aduress of CHA (Channel Request blocan) 
2 Interne) registers: 
3 . KS S&S address of a UCB 
5 ®7 = Address of internal cate structures 
’ R9 = gaved eddress of tne JIA 
} ee 
UDASINIT Ze: 


TALI 

JS eee 

PuSHR Q*MCRS s Save rezisters 

Bice? Sonat aRLRtAL (87 snctiniuuts,c or cisertiecssn ant 
e ASM.ON SUDa a 

nates igneu FLAGSLR 7 3 Controtier om life tiecs 
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47 48 
esc SUDAS VABUFALNC,© 3 Acquire system pool it net already 
-UDASWLFLAGS(R75,55 } allocated ana mapped to tne Urt 
Baw. -£$s¢-: : : $ FKeain UDA Initfsellzation 
S83 MOVZBa S*e},UNASHLINITIFRXR(97) 3 Load cutfer elloc feiiure flag 
MOVZWL @fRut sK Size Ri 3 Loao putfer size 
BSRa UDACALONONPAGED + Get a system butter 
SLbe Ru,10$ 
358 3 Allocation failure 
1083 Bis? @UDASM.BUFALOC,= 3 Flag butter allocated 
UvASWLFLAGS(R7) 
MUVAB upceur ela (kad - 3 Save address of internal *SCcP 
UDAST CT WTPOQUE(R?S } Packet queve listnead 
MUVAR ACTSLICMDILIST(R?),< 3 Save address of Active “SCP 
UDASLUCMDSLIST(R?) 3 Command pacwet List 
MOVL R5,K9- ? Save andress of ILA 
MOVG IDRSLAUCRLST(RS) - : Save adaress of UCK 0 
UOASLLUCRSZERUCRS) - 
MOVAB  UCBS.CLUNE(R2),k8 $ Loaa clone UCo address in #5 
MUVL RS,IDSSLLOWNER (RI) ¢ Set clone to owner uUCe in ILS 
MUVL RS, UDASLICLONEUCA (27) : Save adsress in local data structure’ 
MOV wn sUCuSK SIZE, UCRSWSiZe(K5) 3 Create a bare penes UC 
MOVE ®DYAECLUCH,UCHSBATYPE(R®S) ¢ Loac data structure size ana tvpe 
MOVp S*eFORK TPL ,UCBSBOFIPL(RS) 3 Load fork IPL 
MOVL Ry, UCBSLeCRBC KS) ~ - ¢ Loaa adaress of CaF 
MOVL Ro, UCbSLeUNS (KS) ? Load address of Duo 
MOVAR UCASLIOTOOFI-(C RS) ,NCBSLLTQOFL(R5) ¢ Inftialize iM cueue listhea 
MUVAR UCRSLIIVOFL( RS) ,WCASLLTUGeL (RS) 
Yuva S*ey,UCSSwlUNIT(RS) 3 Set unit number to ¥ 
MuVes S*#DEVICELIPL,UCRSS_DIPL(K5) 3 Load device IPL 
CLRL UCRSLLOPCNT(RS) ! Clear 1/0 count field 
MUVA R1,UCéSwobCwT(R5) 3; Load pyte count 
PICad  s*CcVASMIBYTED,R2,° ? Load pyte offset trom nace 
UCBSwoIBUFE (RS) 
MuVw NCRASKIROFF (KS) pUPASAHIBIFFECRI) 3 Save tor driver 
MUVL RZ,UDASuAbUFTOP(R7) + Save puffer address for internal use 
3 Eliminate Cliene UCP and Active 4SCP Pacxet List from mapring 
Suh a2? RKCUCKHSKAICLN SIZE >e<eCPKESKIUSILZESCPKESROLISTILENDD,= 
UCBSWORCNT (RS) 
JSP G*¥*4GSSvAPTECHK y Get SVAPTE tor ovutter’s virtual acd 
POVL RZ, UCKSLASVAPIE(R5) ! Loaa ouffer System virtua] ainress 
INCa UDASwWLOINTSLERRORT) ? Set maoving fallure flag 
JsR G*TtuCsALOURAMAP : Allocate JUBA Marnring reaisters 
BLAC Ru,40s 3 Allocation Fallure 
BiSs2? sUBASMBIIFMAPL,= : Flag putfer mappes 
UDASw FLAGS(R75 
MOVL CKRSLIINTOSVECSWOMAPREG( FG), 
UDAS 4S MAPREG(R?) ; ? Seve UBA mapoinyg context : 
JSR G* TUCSLOADUBAMAP + Load UBA mapting registers tor uls 
“1583 VOVL UDASLICLONE UC eC?) KS : Get address or clone UCk 
MOVaR CONTINULAINIT, UCBSLFPC(RS) s Init tork °C adaress in tick 
MUVZRa S*e3,UDASHLINITSERR(R7) 3 Set Step 1 failure flaa 
CLRa UDATE( R41) : Reqin ULA initialization sequence 
CLRL Ri : Clear index reaister 
2583 MUVZWL WJuASACR4), Rv. ? Read UDASA © 
MUVA PO,URAS AAS TEPLEKR (RT) : Load ster word in error bufter 
BBS - FIN ETIVIERRUR RU, 355 : Step 1 error, end init seauence 
RbS SINITIVISTEP! PO, 30S ? Step one completion flag set 
AURLSS #LOOPLETMIT,AL, 255 ? Loop 
PRb 356 3; Step one completion error 
308: INCa POA SWaENTTCRRERT) ; Set potential interurt tailure 
BISa? BCUVASNISZEXPCTLUDASHMLINTEXPCI>, © 
UBASWIOFLAGS(R7) 7 Set step two interupt exvectes 
MOVw SSTEPEDDMRITE,UDASA(RA) 3 write step one sord to UDA 
356; Ron e*M<CR5,RT,RO> . y Restore reaisters 
40$: POPR BAMERS ROS ~  —¢ Restore registers 
PRrw . UDA. Delonas 3 Releas® resources anid return 
epee CuMPlisVesINilt © oA Controller Inmitialization Cortinuetion 
» G f Li 
+?¢ 


CUNTINUELINIT = Controller initialfzation seacence continuation 
Functional vescription . 

/TBS/ 
IkL Level = Fork IPL 


Inputs: 
k3 = Pointer to JDA registers 
Ka = Adagress of internal aata structures 
R5 = Adagress of clone UCR 


Se va te te ue we te Be Se te Ne 


eENARLF Lib 


CONTINUL INIT: 
JSP G*F AP SFURK : Create a fork process 
MUVAR ae IN)JT,UCHSLIFPC(RS) 3 Load anterupt continuation atur 
MUVL ee Kz * Get AIP address 
MOVL rf : Copy Internals rurfer address 
TNCw Dok ow. INTILERR(K1) : Flay possible step resmonse error 


: Process controller step LAG SAL ASSAM 


MUVZwL  ULASA( KI) : Get step word from Uda 
MOVa RZ, URASa. bree. FRRC(R1) ? Loau Steo reSponse for possiole err 
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BSC #UDASVAS4EXPCT = 3: Process expectea sten 4 
UDASWLFLAGS (R15, 30S 
Busc #UDASVOS3EXPCT,= 7; Process expecteo step 3 
UDASWIFLAGS(R1),55 
KRICw? RUDAS ASS2EXPCT UP AS wah EAGLES) ; Clear step 2 exnectfa tlaa 
Pa #STEP_?-REAL, RD 3: Is the resvonse correct ? 
BuEG 10s 3? No terminate 
MOVZWL UDASWIBUFF(R1),K? ¢ Loau oyte offset 
InSv UDASIVAPREG( HI)» 89, ~ 3: Set manping register pits U = 4 
ADML2 #kESRSL.TUP, RY : Set address to top of rings 
MOVL PO,@(R1) 3 Save address tor step 
P[Sa2 #INITIMAPURGE ,RU : Set purge enaple flag 
BiSe2  #<UDASM_S3FAPECTIULASYLINTEXPCI>,= 3 Set step 3 and interunt 
UDASWLFLAGS(R1)} , exnectes 
MOVa RO, UDASACK3) fo dyite step word 2 
BRB 208 3 Return to fork dispatcher 
583 CuPw #STEPL3.REAL, 2 3} Is the step 3 response correct ? 
BeQL 156 3 Yes 
1083 - CLPe UDAIP(R3) » Peset UDA on detected error 
RSB : Return to fork dismatcher 
15$: BISw2 —- @<UIDASMS4EXPCTILUDASMLINTEXPCT>,- 3 Set step 4 and interupt 
ULDASWIFLAGS(R1) 7 expectéa 
EXTZV #16,82,2(K1),R9 3 write step 3 word 
MOVa RU, UPASACR3) 
208: INCe HDASWLINITOERR(KI) ; Flag possible interuot tailures 
3083 BBS #INITIVOERROR,R2,19S 3 Terminate init sey or fatal error 
BBC #INITIVISTEP4,R2,1058 $ Terminate it ster sequence error 
BlSw? #5 UOAS AEA 3 Set GU and quad word purst 
? BilSw2  #INLTL¥_GO, UDASACK3) r write Go flaq to UDA 
CLRL UCBSLIFFC(F5) 3 Ciear fork pe in clone Ufo 
CLRL ULDASWLINIT.ERR ORI) 3 Clear init error flags 
3 Map data pase for UDA/Priver and initialize queue listheaas 
MOVZeL UDASWIRUPF CRI), KF? s Develop nA aodress pase for LNs 
INSV UDASWIMAPREGC( KL), 89,89 ,K3 
ADDL? - #CRESPSLATOPSMSCE Sk PRT _LHURD pk ry 
MOVL UDASLIRUFIOP(K1), RO ad ay AGA bese to top of systen pvuffer 
move, keen a 
2, 3 Again 
AUPL2  #KESPSLTUP,RI : Create addr to top of RES Fackets 
MOVAL  RESUSLOFLINA(K2),(RUJ* 3 Initialize Kesponse queue listrea:: 
MOVa4L RESQSLIFLINK(K2), (CRU) + 
TSTL (KO)4 ¢ Skip tutfer descriptor 
MOVAL  CMDUSLAFLINA(K2),(RUI+ ¢ Initialze Command queue listnhead 
MOVAL CMNUSLAFLINK(R2), CRU) + 
MOVAL INTPSLeELINK(iK2), (ROI ¢ Initialize interne) Packet «ait 
MOVAL INTPSLIFLINK(R?), CRUV4 : aueue listhead 
CLRu (KO)+ 1 Clear purge and interurt s#ords 
MOVL #RESPSLITUP, PA : Init index trom top of resnonse Pxts 
3 eye a CRO? ; rise. ACeEe Co ceeeaae rina entry 
58s MUVL 3 Q : nK packe 
MOVZRL $7448, CPKESa -PKIELEW(K1) 3; Load Pet Len an@ clr Vir Cir Tv 
MOVL RO,CPRESLIPIRGPC(RL) 
PISL2 RCUDALMWOWN I UDALMIFLAG>,(RKO)* 3¢ Set entry to UDA Uwn 
INSQUE CPKESLOPOFL(R2) (R4),° - Insert packet In pack of resoonse® gue 
@Q@RFSOSL.IBLINK(R2) 
ADDL? @RESPSKISIZce,kR3 ¢ DNevelor UbA address of neat RES Pxt 
AD?L2 GRE SP ar eet Zeeks 3s Bump index register to next FES oOKt 
ADPL2 #RESPSFISIZE RK ? 
AUBLSS #NSCPSKLRINGSIZE,RS,35$ $ Loop thru all RES ring/pkt entries 
408: MOVL PU, CPKESLRINGP(P1) 
MOVZBL S*#4aR,CPKESH PKICLENC RI) 3 Load Pxt Len ant clr Vir Car Iv 
MOVL R3, (RO) + 3 Link packet to commano ring entry 
JNSGIE CPKESLIPOFL(R2)(R4),- + Insert packet in Dack of command qe: 
RCMDQSLIBLINK(R2) 
ADDL2 #ChLPSKISIZE,R3 3 Nevelop UoA aadress to next crt crt 
ALDL? #CMDPSK.SIZE,R4 t Bump index register to next cmd pet 
ADDL2 #CMUPSKCSIZE,RI 
SORGTRK R5,405 + Loop thru all emd ring/ext entries 
¢ Clear Command Reference humper and UPA Kesource Values Fiela in eacn 
# entry cf the Active MSCP Commana packet List 
ALDL? #ACSLeCMDALIST,R2 ? Point to top of command list 
458: CLRO (kK2) 
ADNL2 #CPKFSK.SIZE,K2 y Point to neat entry 
AUSLSS SEPRFSKILISTOLEW, KS, 458 3 Loop tnrougn list 
: Send UPA eight online packets for units 9 thru 7 
¥MOVAB UDASLIINTEPHAL 3 Reload addr of internal structures 
MOVL ULDASLOINT TEOUECRLD R3 } Get aadress of internal pet lisnead 
ADDL2 $*4#2,R3° $3 Get backlink address 
CURL Ra 3} Clear R4 
3 BSBua UDALGETWINTPKT 3 Get an interna] MSCP packet bufter 
ss ALEC RO,S5S 3 A)jlocation Failure 
MUVE enSCPsk. NP.UNLIN, = $ Load online command in mSCP nacKet 
WSCPSK_UPCOLF(R2) 
MUVw Ra,MSCPSH¥LUNIT(R2) $ Load unit numoer 
MOVw R4,4SCPSULSHDwouUnT(n2) ©: Load shadow unit nusoer 
INSQUE (h2),@€K3) : Insert packet in rear ern? ot queie 
AUBLSs 88,k4,508 : Lonp tor & unline PacKnets 


Unknoan ff nere from SYSSSYsGe" 
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# Sena uPA the Set Controller Characteristics Comnand Packet to enaple 
r Attention Messages and a of Setond nost timeout value. 
RSB« UDA LCETLINTPFT 3 Get an internal tad packet buffer 
RLRC FO,55s ? Allocation Failur 
MUVb amSCPSk. Ap.STCcoi ' Load set Controller Cnaracteristics 
MSCPSHADPCOLE(P 25 ? Op code 
R1Sa2 @MuSCPSMICE SAVATH MSCPS4 OCNTOPLGS(R2) ¢ Set controller floes 
MuVe #00 ,MSCPSaonST. Tha ?) : Set nost timeout to 60 seconds 
RiSw2 sUDASMCUNLINE, Tossa. FLAGS (RI) + Set controller on line tla’ 
LOADLINTOLPRKTs 3 RPeference lahel for internal packet loadina 
MOVL ULASLIIWTROUE(R1),RS 3 Get aodress ot internal pxt lisneai 
ADPL2 $*44,283 3 Get bacxjJink adaress 
ThSuVe CK?) ,e(K3) : TnSert packet in rear end oft quene 
RRw UDALENTERHALOLO > Mue Packet to UvA 
5583 AS ? Error return 
DISAbLE LSu 
eSSTTL WDA Interume Service kKoutine 
2 PAGF 
t +4 
; ULACINTERUPT = Interunt Service xoutine 
* Functiaenal veseriptions 
. f/TBS/ 
¢ Inputs? 
; 9(SP) Pointer to IDK 
, R5 = AAdresS Of Clons® UCK 
‘ Ru = R4 = Scratch 
3 Outputs for routine calle: 
3 R3 = pointer to ULAIP 
I R4 = Address of Internal vata Structures 
: . RS = Adgoress of Clone JC 
UDALINTERUPT?: 
MOVE @(SP)+,K3 3: Get audress or 1Ds 
MOVAAR UDASLIfnTERUAL,K4 ? Get address ot inpternal structures 
BYS B@UPASV—TIMEUIIT,= ? Ignor interuvt if timeout is set.uis 
UDASWLFLAGS( R45, 208 : its inconerent at this noint anyway 
MUVL IDPSLIOwNeER(®3),P9 $ Load owner UCp tor EXeSFORF 
Pac #UNASVIONLIWE = ? Skip puree check if UPA is oftline 
UDASWIFLAGS (Ra), 1US 
MUVL NWDASLIRUFINP(K4$,K2 3; Get acdress of syste™ bufter 
TSTb CMP SRIPURGFOCR2) > Is a cata Datn purae requesten ? 
RedQL 10s : s No, test for normal interuotr 
MUVL UCRSLICRA(RS),R1 : Get address ot CRb 
MUVe CRASLAINTOSVECSEOUATAPATH(P1),<(SP) $ Save current LP in CRr 
MOVE CMDSB.PUPGF(R2),2 3 Loaa data Patn number to be purges 
CRKASLIINTD+VECSOLUATAPATH(P1) 7 Into CRs 
PUSHR e*MeRL,R2,R3> + Save registers trom sys routine 
Jo G*TUCSPURGNATAP 3 Purje tne data Fatn 
POPR a*McR],K2,R3> 3 RPestore previous context 
MOVG (SP)+,CRASL J sTU+VECSHMLALAPATH(P1) 7 Restore orevions 1? 
CuURG CADSBIPURGF(R2) 3 Clear Pate Path in aneeees woTa 
MOVE (h3),R? ? Get address ot YDAT 
CLE DDASACR2) 7; Let Uvs know were sone 
1us: RCC HUNABVOINTEAPCT,© : peceeece interupt if expecter 
UDASWKIFLAGS(R84),155 : rocess possihle artentiaon pxt 
JS# @UCHSLIFPC( RS) ; Go Eo aprropriate routines 
BRR 208 ? Restore registers and ret fro: int 
iss; PLRC UDAS@ FLAGS (PG), 20S : Tgnor unsolicited interunt if tne 
7; UVA {8 off Line 
Ans #VASVISYSTER,= : Tt clone isn’t already in for auene 
UCKSI _LFPC(W5),2uS $ put 1t there to get ressaue pacret 
PORn 3us * Create a tork process 
2Uu83 MuVu (sP34,ks ? Restore registers 
MUVEe COP)+,R2 
MOVE (OP)+,%a8 
Fel 
303 JSR G*FAFSFIRK ? Gracetully go to fork IP! 
BW ULDALFORKOPRUC 7 ‘lIse tne standaro tork processor 
? for unsolicited Attention Y“essayes 
eSPFSTL UDALINELOAD «= UPA driver unloaa routine 
ePAGE 
3 +4 ; 
f ULDALUNLUAD © uFiver unluas routine. 
’ 
$ Functional beseription: 
: /TRS/ 
} 
: 


Inputs: 


UDA.WUNLUAL $ 
PuSnP 


MOVAR 
Boc 


RBC 


vee we Ne 


we 


Save registers 
Get aagdress of internal structures 
Exit if no syste™ buftrer aliocatead 


Skip clone unlinking it never linxe: 
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MUVL UDASLICLONEUCH(R6) RS ? get address of Clone UCr 
MOVE UCBSLODEVDEPERD (R$ ,Ro $ Get audress of cack linked UCs 
CLREL UCRSLILINK CRS) 3 Set tnis uCu to last ~ 
Ss: RBC #UDASVBUFMAPD, © t Exit if butter not mapped to usa 
NDASWIFLAGS(Re$,1U8 | 
MOVE UDASLICLONEUCB(R6) RS $ get address of Clone uCn 
MOVL UCASLICRA(RS5S), RS 3 Get aadress ot CRo 
MOVL UDASW.YAPRKEG(REA) ,° i Loau URA context in CK 
CRASLIINTDSOVECS a MAPREG(R4) 
JSB G*TOCSRELMAPREG 2 Release mapping registers 
108: MOVL ULDASLIBUF TOP CRO) RO 3 Get address of system Bufter 
BSBa UDA CDEANONWPAGED 9 Neallocate svstem buffer 
15838 MUVL S*OSSSILNORMAL, PO ’ Set normal tor caller if kKeloadina 
CuRw PeneeT Na es us s Reset al} flays for internal init 
- POPR O°MCR1,R2,P3,R4,R5,R6> ¢§ Restore resisters 
RSR $ Return to caller 
eSFITL Oriver support Koutines 
eo PAF 


++ 

UDACRESETLRINGS © Routine to set tne Resnonse rina’sS own tlad to wta ute, 
and clear tne first auadwors in tne active commons list 
entry mointed to oy PZ. 


Re te Te Me Ve We Be te te 


Inputs: 
Rv = Adaress of response packet 
= R2 = Aduress of command packet iist entry 
UDO SRESETIRINGS: ; 
BISL? SUDALMIUWN, = + Set resconse rina to Ula Ge. 
ACPKFSLIRINGPO(RU) 
CLRw (k2) ? Clear “SCH Commans nererénce nutter 
: £ And pd Resources fields an List erty 
Rob 
2 ¢¢ 
: GETLENWDIPACKET = Routine to get tne next avallaole resronse pacnet trom Nya 
3 Functional vescriptions 
3 /TRS/ 
? 
* InPuts? 
; Rl = Address of internal uata structures 
° 
$ Outputs: 
3 RU = Aduress of End packet or 9% {f£ next nmacket pelonaed to ula 
3 or no comand packet matc® wes found, : 
; R2 = Address of Active Conmand Packet w#witn same reference nutser, oF 
; undetinea 1f No maten was founa 
GET.WENDLPACKET® 
MOVQ R3,<(SP) 3 Save K3 and ki 
VOVL Uva si BUF TOP( RID, 14 } Get address or svste> bufter 
5s: MUVL ReSuSLePUINK CK4) RO : Get aodress of next response pace! 
RBS SUDA eV, O@CPKESLIKEINGP(RO),298 ¢$ Packet pelongs to us 
Bus #HSCPSVIOPLEND, © ? Process End Packet if flagues 
MSCPSBOOPCHLE (RU) ,108 
BSAd ALITENSTUNIMSG 3 Process attention messaue 
Baa 5s 3 Trv it aaain 
lus: REMQUE @KFSOSLIFLINK( RS), Pu : Retove packet from tront of queue 
INSVUE (CRO), @RESQSLIBLINK (m4) 6§ INnSert in back of queue 
CLPL R3 ° + Clear loop index 
MOVAB pcp er eCADeeIs Li Reyes ? Get address of tirst comtana packer 
19s; CMPL CPKESLICMDIREF(R2),¢ 3 Compare reference mutvers hetaren 
MSCPE VaCWIORFEE (RO) $ Fesuqnese and comrana packets 
BeOu 258 ? Foun4 the matcn 
ADOL? OCPKESK OS1Z2e,#2 3 Pofnt to next entry ; 
AOPLSS @CPKFSKILISTIOLEN,RI,15$ ¢ Loop througn al) Commang packets 
RISL2 SsUDALMOOWN, @CPKESLIALaGH(HO) 3 set rina entry to UDA own 
208% CLRL RO : Set no response oacaet avallaole 
2583 MOVU (SP)+,R3 3 Restore reqisters 
RSS ¢ Return to caller 


3 44 

7 ATTENTIONIMSG © Attention Yessaye Processin; koutine 

? 

* Functional vescriptions 

? TE the message received is an Availeble Attention Messaue, tnen at. UN-Line 

$ internal SCP nacwet is generated for tne unit declared, the otner torts ot 

; attention messages are currently idnored. 

. 

3 InPufs: 

3 RO = Aduress of Message Packet 

: Ril = Address of Intern4l Data Structures 

ATTENTIONIMSG? 
BLAKC ULDASHFLAGS(R1),2uS 2 Ignor essage it ute went otfiine 
CMP OMSCPSK OPLAVATN, SSCP SR LNPEQDE( RD) 
RNEw 2us 3 Ignar nonwavallarle attn vessare 
MUVG RO,<-(5P) 3 Save inovt context 
BSBe UDALGETILINTPKT ! Get a systen outfer for internals pet 
ALAC RO,15S + Allocation failure, {gnor reauestr 
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MUVS (SP)4,RU ¢ Restore inout context 
MUVA - MSCPSwlUNIT(R8U),@ ? Loaa Unit Numper 
MSCPSwoUNIT(R2) ‘3. From attention messete packet. 
OVA MSCPSa_UNIT(RU),= + Load Shadow linit vunber 
MSCPSalsHun LNT (PR 2) 
MOVb “OMSCPSKIOPLONLI AW, ? Load online comand 
MSCPSS.UPCODE (P25 
1083; VOVL ULASLIINTPIVE(P1),R3 : Get internal packet queue listneag 
ADPL2 = S*#a,n3 ? Get back Link 
TRSQUE  -€R2),8¢(R3) 3; Unsert packet in rear of queue 
BR 2us 3 Clean up and return 
156: MuVo (SP)4,Rv ? Restore indut context 
2083 RPEMQUE ARF SOSLIFLINK( Ra), Ru : Pemove packet. from tront of queue 
TaSyllé (KO) ,@RESUSLIBULIACRY) 3 Insert in bacx of ueVe 
peeled #UDALMUWN, ACPKESLIKTAGPCKO) . ¢ Set rang entry te pA Own 
» PAGE 
3 +¢ 
; GET.CMD_LPACKEL = noutine to aqet the next comtans packet for caller 
3 Functional vescription: 
8 /TBS/ 
; 
? Inputs 
3 Ri = Address of internal aata Structures 
9 Outguts: 
3 Ro = Success = Address of emply command vacket. 
; RPO = Failure = 0 ifs 
? 1) Uwn bit set indicating tvA oans pacret 
? 2) Uwn vit reset pvt £lad bit set indicating 
z packet {fs still active, 
: R2 = Address of empty Active “SCP Command pacwet entry 
GeT_Cap @BACKEL? 
PUSHL Ri 3 Save #1 
MUVL UDASLICAN_LLIST(R1) RR? 3 Get audress otf commana list 
UOVL UDASL RUF SE FOP (KI), RI 2 Get aadress ot systen bufter 
MOVE CHDSELLFLINK ERTS RO : Get aodress of next Packet 
BbS SUDALVAOOWN ,@CPKESLORINGP(KO) ,205 3 kacket belongs tu ums 
CLPL Ri 3 t loop index 
Ss: TSTL C(R2) : Is tis entry empty ? 
BeOu lus 3 Yes, use it 
ADPiL? S*acCPKESK SIZE,K? ? Bump pointer 
AUKLSS asCPRESKLLISICLE& 1,55 ¢ Loop 
PRR 208 ; Kecive list Ane tull 
1uS$; CURL RI ¢ Init Loop inde 
1583 CLRu MSCPESLIOCMLIORKEF CKO) ERI) 3 Clear MSCP Packet for calier 
AUBLSS #MSCPSKIPATSIZFE@~3,R1,15$3 
POPL Ri s Restore. Ri 
JOR @(SP)+ ys Execute corroutine ‘call to caller 
3 Return nere if commana packet can he queved to the UDA 
PUSHL Ri : Save Ri 
VuVL UDASLIBUFLOP(R1),RI 3 Get agdress of systen Pufrer 
REMQUE Q@CMLOSLIFLINK(R1S,Pu 3 Potate packet from tront of ayeue to 
ThSute CRO), SCANGSLIGLINACRI) 8 ¢ back of queve 
b1iCu2 SUN ALMLFLAG, © ? Clear fiag pit in ring entry 
@CPKESLLRINGP( RO) 
PISL? BUPALMAUWN,@ fF Set packet to IDA own 
@CPKESL IR IfGP( RO) 
208; CLRL Ru 3 Set failure fley if nere trom apove 
PUPL RI : Restore Fi 
RSP 2 Return to caller 
« PAGF ; : 
I + ‘ 
+ UDALGETLINTPKT = Allocate a systew buffer for an internal “SCP packet 
3 
3 Functional Description: 
3 Calls ULALALONOWPAGEN for the bufter. Clears the 48 bytes ot packet 
3} to zeroes for caller, and loads next niyher internal MSCO Pacxet 
? command reference numper. 
? 
} Inputs: none 
? Outputs: 
? RO = success or fallure as received from EXESALUNUNPAGDFEYD 
! Ri = Address of tnternals 1£ allocation succeeded else tras, 
! R2 = address of huffer 
3 soe 
UDA_GETCINTPKT: . 
MOVL SCMSCPSKIPKTSIZE+12>,K1 3 Nefine size or system bufter needed 
BSR UDALCALONOWPAGED y Get SyStem voutfer 
BLAC Ru,155 2 Allocetion failure, fynor request 
CLRL R1 3 Init loop index 
Ss: CLR MSCPSLoOCYUCRER(R2)0R13 3 Clear Packet 
AURLSS #MSCPSKUPATSIZEe-3,k1,55 
MOVAB UDASLILINTEPNAL,RI # Get internal’s address 
1083 InCe UDASWLREF. NuM(A1) 3 Make a n@s commana reference numver 
BEG, “408 3 But not a zero 
MGVa UDASWIREFLNUM(RI),= ? Loan packet’S comnand reference no 
MSCPSLC*DONEF(K2$ 
1583: RSB 
PAGE 


++ 
UDALALONONPAGED = Allocate a buffer from system space for caller 
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Functional Description: 


Calls FAPSALONONWPAGER and inserts bufter size anit tyne in olock if succes 

Saves Fj for caller. R3 usually contains the address of an 1lFr. 

Inputs: 
R1 = Size of vlock 

Outputs: 
RQ = lew bit clear inoicates failure 
PO = lew pit set incicates success 
Rl = Size of butter 
RZ = Adsaress of bufter 

DALALONOWPAGEDs . 
PuShR a*M<CP),kI> ? Save K3 and requested Hufter stze 
JS8 G*EAESALOWOWPAGED : Renuest a system puffer 
PGP a°™<CR1,RI> 3: Restore reaisters 
RLFC Ru,os + None avatlaple, return 
MOVa RP1,IRPSwoSIZF(R2) 3} Loago size descrictor in bhufter 

as pepe ®LYNSC.DUFIU,IRESHOTYPF(RZ) 3 Define tyne 


UDALDEANONWPAGEN = Deallocate a puffer from system Space for caller. 


Functional Description: 
Calls FXESDEANONPAGED and saves Riek} for caller 


Inputs: 
RO = Adoress of bufrer to be Jeallocated 
Outputs: None 


VALDEANC feeeees 
PUS 


weMCR1 PR? ,P 43> : Save registers 
JSR. G*EXESHEAROL.PAGED ? Peeallocate system outfer 
Fore #oMCPL,R2,R3> : Restore reqisters 
5 
ie «PAGE 
UDALIUPOSI = 1/0 post processing routine 
Functional Description: 
/TBS/ 
Inputs: 
R3 = Address of IKP to post process 
RS = Adaress of the ubfsqgnitous Clone uCr 
R7 = 1/0 Status long word 1 
Rb = I[/0 status long word 2 
Outputs: None 
DAWIOPUST 3 
MOVL Ru,o(SP) 3 Save RO 
KuVu R7,LRPSLSMFLIACK3) } Loaa tinal status in Lee 
OeCL UCKSLOPCNT(RS) ¢ Account for T/A in Clone ice 
MOVE IRPSLINCI( RI), EO : Get address of real ‘ICR ; 
TNCL UCRSLoOPCuT (RU) : Account for I/9 in real tux ete 
MUVAR G*TUCSGLIPSEL, Pu + Get acdress of incost aveur Listhes: 
TnSulle (€K3),0€K9) : Insert IRP in Dost oroceSs Gieue 
NEW 10s : Branen if not first entry 
SUFTINT #1°LS.TUPUSi * Initiate sotteare Interurt 
Os: noxt (SP)4+,Ru 2 Pestore RO 
a ; 


+¢ 
LINKACLONE = koutine to link the Clone uC at tne end of the Lee uist 
tor access by the timeout nandler, 


Inputs: 
RS = Address of clone 'ICK 


Registers Usea: Ru,k? 


INKOCLUNE ¢ 

MOVL UCRSI LCKAC RS) -RG 3 Get aadress of (CRs 

MOVL CKRSLLINTOSVFESLIIPA( KO), KO : Get aadress or ifis 

MUVL TOPSLIUCKLST (RO) RO : Get aodress of tirst uCr - 
$: MOVL UCBSLOLINK CHO) ,k? + Get link to next UCo trom tnis utr 

BeQu 1us 3 Tnis one was the iast 

MOVL P2,K0 t Load ajdress of next UCR 

BHA 5s 2 Continue search for last in list 
OS; MOVL R5,uCpoSueLInk (RO) 3; Link tormer last uCd te cinne 

MOVL RO,UCDSUADFVDEPENDC(RS) ¢ Loag back pointer in Clone 

CLRL YCASL_LLINK(RS) ? Set clone to last 

CuRu UCBRSLIFRC(K5S) : Clear for«k PC field 

RSB : RFerurn to caller 
DALEND: ¢ All aqood thinus muSt come to an eni 
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What is claimed is: 


1. In a data processing system which includes first 
and second processors (70 and 31), a memory (80) to 
which information can be written by each of said pro- 
cessors and from which information can be read by each 
of said processors, such memory having a plurality of 
locations for storing said information, and bus means 
(60) for interconnecting the first and second processors 
and said memory, to enable communications therebe- 
tween, said bus means being of the type which has no 
hardware interlock capability which is usable by the 
other of said processors to selectively prevent the other 
of said processors from accessing said memory loca- 
tions, the improvement comprising: 

+ communications control means for controlling com- 
munications between said processors and permit- 
ting the first processor to send a plurality of com- 
mands in sequence to the second processor via the 
bus means, and for permitting the second processor 
to send responses to those commands to the first 
processor via the bus means; 

the communications control means including a plural- 
ity of locations in said memory, termed interface 
memory locations, adapted to serve as a communi- 
cations interface between the first and second pro- 
cessors, all commands and responses being trans- 
mitted through such interface memory locations; 

the interface memory locations comprising a pair of 
ring buffers; 

a first one of said ring buffers being adapted to buffer 
the transmission of messages issued by the first 
processor and a second one of said ring buffers 
being adapted to buffer the reception of messages 
transmitted by the second processor; 

each of said ring buffers including a plurality of mem- 
ory locations adapted to receive from an associated 
one of said processors a descriptor signifying an- 
other location in said memory; 

for said first ring buffer, the location signified by such 
descriptor being a location containing a message 
for transmission to the second processor; 

for said second ring buffer, the location signified by 
such descriptor being a location for holding a mes- 
sage from the second processor; and 

the communications control means permitting each 
of said processors to operate at its own rate, inde- 
pendent of the other of said processors, and to 
access a ring buffer for writing thereto only when 
the buffer does not contain information previously 
written to such buffer but not yet read from it and 
for reading to such buffer only when the buffer 
contains information written to it but not yet read 
therefrom, thus preventing race conditions from 
developing across said bus means in relation to 
accessing the interface memory locations. 


2. The apparatus of claim 1 wherein there is associ- 
ated with each ring buffer entry a bit whose state indi- 
cates the status of that entry; 

for each entry of the first ring buffer, the first proces- 

sor being adapted to place such entry’s ownership 
bit in a predetermined first state when a descriptor 
is written into said entry, and the second processor 
being adapted to cause the state of the ownership 
bit to change when such descriptor is read from 
said entry; 

for each entry of the second ring buffer, the second 

processor being adapted to place such entry’s own- 
ership bit in a predetermined first state when a 
descriptor is written into said entry, and the first 
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processor being adapted to cause the state of the 
ownership bit to change when such descriptor is 
read from said entry; 

the first and second processors being adapted to read 
ting buffer entries in sequence and to read each 
ring buffer entry only when the ownership bit of 
said entry is in said predetermined first state, 
whereby an entry may not be read twice and an 
entry may not be read before a descriptor is written 
thereto. 

3. The data processing system of claim 1 wherein the 
communications control means is further adapted to 
provide such communications while each of the proces- 
sors is permitted to operate at its own rate, independent 
of the other processor, and while avoiding processor 
interruption for a multiplicity of read and write opera- 
tions. 

4. In a data processing system which includes first 
and second processors (70 and 31), a memory (80) 
adapted to be used by said processors for containing 
information to be shared by the processors, and bus 
means (60) for interconnecting the first and second 
processors and the memory, the bus means (60) being of 
the type which has no hardware interlock capability 
which is usable by each of said processors to selectively 
prevent the other of said processors from accessing at 
least a portion of said memory, the improvement com- 
prising: 

the first and second processors (70 and 31) being 
adapted to employ a portion (80A) of said memory 
as a communications region accessible by both of 
said processors, so that all commands and re- 
sponses can be transmitted from one of said proces- 
sors to the other of said processors through such 
portion of memory; 

the communications region of memory including a 
pair of ring buffers (80D and 80E); 

a first one of said ring buffers (80D) buffering the 
transmission of messages issued by the first proces- 
sor (70) and a second one of said ring buffers (80E) 
buffering the reception of messages transmitted by 
the second processor (31); 

each of said ring buffers including a plurality of mem- 
ory locations (e.g., 132, 134, 136 and 138) adapted 
to receive from the associated transmitting one of 
said processors a descriptor signifying another 
location in said memory; 

for said first ring buffer, the location signified by such 
descriptor being a location containing a message 
for transmission to the second processor; 

for said second ring buffer, the location signified by 
such descriptor being a location for storing, at least 
temporarily, a message from the second processor; 
and 

the first and second processors (70 and 31) further 
being adapted to control access to said communica- 
tions region (80A) such that information written 
therein by one of said processors may not be read 
twice by the other processor and a location where 
information is to be written by one of the proces- 
sors may not be read by the other processor before 
said information has been written, 

so that race conditions are prevented from develop- 
ing across said bus means in the course of inter- 
processor communications, and messages are trans- 
mitted from said ring buffers in the same sequence 
as that in which they are issued by the processors, 
while each of the processors is permitted to operate 
at its own rate, with substantial independence from 
the other processor. 
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5. The apparatus of claim 4 wherein said ring buffers 
are adapted to permit the first processor to send a plu- 
rality of commands in sequence to the second processor 
via the bus means, and to permit the second processor to 
send responses to those commands to the first processor 
via the bus means. 
6. The apparatus of claim 5 wherein the first proces- 
sor (70) is a host computer’s (1) central processor, the 
second processor (31) is a processor in a controller (2, 
30) for a secondary storage device (40), and the bus 
means includes an input/output bus (60) for intercon- 
necting said host computer with said secondary storage 
device. 
7. The apparatus of claim 5 wherein there is associ- 
ated with each ring buffer entry a byte of at least one 
bit, termed the ownership byte (FIG. 3B-133, 135, 137, 
139; FIG. 8-278), whose state indicates the status of that 
entry; 
for each entry of the first ring buffer (80D), the first 
processor (70) being adapted to place such entry’s 
ownership byte in a predetermined first state when 
a descriptor is written into said entry, and the sec- 
ond processor (31) being adapted to cause the state 
of the ownership byte to change when such de- 
scriptor is read from said entry; 
for each entry of the second ring buffer (80E), the 
second processor (31) being adapted to a place such 
entry’s ownership byte in a predetermined first 
state when a descriptor is written into said entry, 
and the first processor (70) being adapted to cause 
the state of the ownership byte to change when 
such descriptor is read from said entry; 
the first and second processors being adapted to read 
ring buffer entries in sequence and to read each 
ring buffer entry only when the ownership byte of 
said entry is in said predetermined first state, 
whereby an entry may not be read twice and an 
entry may not be read before a descriptor is written 
thereto. 
8. The apparatus of claim 7 wherein said ownership 
byte (278) is the most significant bit in each descriptor 
(260, 264). 
9. The apparatus of claim § wherein the controller (2, 
30) further includes pointer means (32, 34) for keeping 
track of the current first and second ring buffer entries. 
10. The apparatus of claim 5 further including means 
for limiting the generation of processor interrupt re- 
quests to the first processor in connection with the 
sending of commands and receipt of responses by said 
processor, such that interrupt requests to said processdr 
are generated substantially only when an empty ring 
buffer becomes not-empty and when a full ring buffer 
becomes not-full. 
11. The apparatus of claim 10 wherein the size of each 
ring buffer is communicated by said first processor to 
the second processor at the time of initializing a com- 
munications path betweem them. 
12. The apparatus of claim 11 wherein the processors 
(70, 31) communicate by sending message packets to 
each other, and further including: 
the first ring buffer (80D) being adapted to hold up to 
M commands to be executed; 

an input/output device class driver (3) associated 
with the first processor (70) for sending commands 
to and receiving responses from an input/output 
device (40); 


the second processor (31) being adapted to provide to” 


the class driver (3) in its first response packet the 
number M of commands of a predetermined length 
which said buffer can hold; 
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the class driver being adapted to maintain a credit 
account having a credit account balance indicative 
of the number of commands the buffer can accept 
at any instant; 

the credit account balance initially being set to equal 
M and being decremented by one each time the 
class driver issues a command and being incre- 
mented by the value; 

the second processor further being adapted to pro- 
vide to the class driver, with each response packet, 
a credit value (FIG. 9, 288) representing the num- 
ber of commands executed to evoke the response; 

the class driver incrementing the credit account bal- 
ance by said credit value; and 

the first processor and. class driver being adapted so 
as not to issue any commands when the credit ac- 
count balance is zero and further being adapted to 

. issue only commands which are immediately exe- 
cuted when the credit account balance is one. 

13. In a data processing system which includes first 
and second processors, (70 and 31) a memory (80) 
adapted to be used by said processors, and bus means 
(60, 110, 90) for interconnecting the first and second 
processors and memory to enable communications 
therebetween, said bus means being of the type which 
has no hardware interlock capability which is usable by 
each of said processors to selectively prevent the other 
of said processors from accessing at least a portion of 
said memory, the improvement comprising: 

at least a portion (80A) of said memory (80) being 
adapted to serve as a communications region acces- 
sible by both of said processors all commands and 
responses being transmitted from one processor to 
the other through such portion of memory; 

means (278) for controlling access to information in 
said communications region whereby information 
written therein by one of said processors may not 
be read twice by the other processor and wherein a 
location where information is to be written by one 
of the processors may not be read by the other 
processor before said information has been written; 

the communications region of memory including a 
pair of ring buffers (80D, 80E); 

a first one of said ring buffers (80D) being adapted to 
buffer the transmission of messages issued by the 
first processor and a second one of said ring buffers 
(80E) being adapted to buffer the reception of mes- 
sages transmitted by the second processor; 

each of said ring buffers including a plurality of mem- 
ory locations (e.g., FIG. 3B-132, 134, 136, 138) 
adapted to receive from an associated one of said 
processors a descriptor (260, 264) signifying an- 
ather location in said memory; 

for said first ring buffer, the location signified by such 
descriptor being a location containing a message 
for transmission to the second processor; and 

for said second ring buffer, the location signified by 
such descriptor being a location for holding a mes- 
sage from the second processor, 

so that race conditions are prevented from develop- 
ing across said bus means and messages are trans- 
mitted from said ring buffers in the same sequence 
as that in which they are issued by the processors, 
while each of the processors is permitted to operate 
at its own rate, independent of the other processor. 

14. The apparatus of claim 13 wherein said ring buff- 
ers are adapted to permit the first processor to send a 
plurality of commands in sequence to the second pro- 
cessor via the bus means, and to permit the second 
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processor to send responses to those commands to the 
first processor via the bus means. 

15. The apparatus of claim 14 wherein the first pro- 
cessor is a host computer’s (1) central processor (70), 
the second processor is a processor (31) in a controller 
(2, 30) for a secondary storage device (40), and the bus 
means includes an input/output bus (60) for intercon- 
necting said host computer with said secondary storage 
device. 

16. The apparatus of claim 15 wherein there is associ- 
ated with each ring buffer entry a byte of at least one 
bit, termed the ownership byte (FIG. 3B-133, 135, 137, 
139; FIG. 8, 278), whose state indicates the status of that 
entry; 

for each entry of the first ring buffer (80D), the first 

processor (70) being adapted to place such entry’s 
ownership byte in a predetermined first state when 
a descriptor (260, 264) is written into said entry, 
and the second processor (31) being adapted to 
cause the state of the ownership byte to change 
when such descriptor is read from said entry; 

for each entry of the second ring buffer (80E), the 

second processor (31) being adapted to place such 
entry’s ownership byte in a predetermined first 
state when a descriptor is written into said entry, 
and the first processor (70) being adapted to cause 
the state of the ownership byte to change when 
such descriptor is read from said entry; 

the first and second processors being adapted to read 

ring buffer entries in sequence and to read each 
ring buffer entry only when the ownership byte of 
said entry is in said predetermined first state, 
whereby an entry may not be read twice and an 
entry may not be read before a descriptor is written 
thereto. 

17, The apparatus of claim 15 wherein the controller 
further includes pointer means (32, 34) for keeping track 
of the current first and second ring buffer entries. 

18. The apparatus of claim 15 further including means 
for reducing the generation of processor interrupt re- 
quests to the first processor in the sending of commands 
thereby and responses thereto, such that interrupt re- 
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quests to said processor are generated substantially only 
_ when an empty ring buffer becomes non-empty and 
when a full ring buffer becomes not full. 

19. The apparatus of claim 18 wherein the size of each 
ring buffer is communicated by said first processor to 
the other of said processors at the time of initializing the 
communications path between them. 

20. The apparatus of claim 19 wherein the processors 
communicate by sending message packets to each other, 
and further including: 

a buffer associated with the second processor for 

holding up to M commands to be executed; 
an input/output device class driver associated with 
the first processor for sending commands to and 
Teceiving responses from an input/output device; 

the second processor being adapted to provide to the 
class driver in its first response packet the number 
M of commands of a predetermined length which 
said buffer can hold; 

the class driver being adapted to maintain a credit 

account having a credit account balance indicative 
of the number of commands the buffer can accept 
at any instant; 

the credit account balance initially being set to equal 

M and being decremented by one each time the 
class driver issues a command and being incre- 
mented by the value; 

the second processor further being adapted to pro- 

vide to the class driver, with each response packet, 
a credit value representing the number of com- 
mands executed to evoke the response; 

the class driver incrementing the credit account bal- 

ance by said credit value; and 

the first processor and class driver being adapted so 

as not to issue any commands when the credit ac- 
count balance is zero and further being adapted to 
issue only commands which are immediately exe- 
cuted when the credit account balance is one. 

21. The apparatus of claim 16 wherein said ownership 
byte is the most significant bit in each descriptor. 
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